pinvoke.net: Edit: ole32.CreateILockBytesOnHGlobal

@msdn=http://search.microsoft.com/search/results.aspx?qu=$$$
@pinvoke=http://pinvoke.net/$$$.htm

Summary: The CreateILockBytesOnHGlobal function creates a byte array object, using global memory as the physical device, which is intended to be the compound file foundation. This object supports a COM implementation of the ILockBytes interface.

!!!!C# Signature:
        /// <summary>
        /// The CreateILockBytesOnHGlobal function creates a byte array object, 
        /// using global memory as the physical device, which is intended to be the 
        /// compound file foundation. This object supports a COM implementation of the 
        /// ILockBytes interface.
        /// </summary>
        /// 
        /// <param name="hGlobal">The memory handle allocated by the GlobalAlloc function. 
        /// The handle must be allocated as moveable and nondiscardable. If the handle is 
        /// shared between processes, it must also be allocated as shared. New handles should 
        /// be allocated with a size of zero. If hGlobal is NULL, CreateILockBytesOnHGlobal 
        /// internally allocates a new shared memory block of size zero.</param>
        /// 
        /// <param name="fDeleteOnRelease">A flag that specifies whether the underlying handle 
        /// for this byte array object should be automatically freed when the object is released. 
        /// If set to FALSE, the caller must free the hGlobal after the final release. If set 
        /// to TRUE, the final release will automatically free the hGlobal parameter.</param>
        /// 
        /// <param name="ppLkbyt">The address of ILockBytes pointer variable that receives the 
        /// interface pointer to the new byte array object.</param>
        /// 
        /// <returns>This function supports the standard return values E_INVALIDARG and E_OUTOFMEMORY, as well as the following:
        /// S_OK: The byte array object was created successfully.</returns>
        [DllImport ("ole32.dll")]
        public extern static int CreateILockBytesOnHGlobal(IntPtr hGlobal, [MarshalAs(UnmanagedType.Bool)] bool fDeleteOnRelease, out ILockBytes ppLkbyt);

or 
 [DllImport("ole32.dll",
	EntryPoint="CreateILockBytesOnHGlobal",
	ExactSpelling=true, PreserveSig=true, CharSet=CharSet.Ansi,
	CallingConvention=CallingConvention.StdCall)]
 static extern int CreateILockBytesOnHGlobal(IntPtr /* HGLOBAL */ hGlobal, bool fDeleteOnRelease, [MarshalAs(UnmanagedType.Interface)]out object /* ILockBytes** */ ppLkbyt);

!!!!VB.NET Signature:
Public Class Win32
    <DllImport("ole32.dll")> _
    Public Shared Function CreateILockBytesOnHGlobal(ByVal hGlobal As IntPtr, _
                                                      ByVal fDeleteOnRelease As Boolean, _
                                                      <Out()> ByRef ppLkbyt As IlockBytes) _
                                                      As Integer
    End Function
End Class

!!!!User-Defined Types:
None.

!!!!Notes:
None.

!!!!Tips & Tricks:
Please add some!

!!!!Sample Code:
With VB.NET,

Dim lockbytes As IlockBytes = Nothing
Dim hr As Integer
hr = Win32.CreateILockBytesOnHGlobal(IntPtr.Zero, True, lockbytes)

!!!!Alternative Managed API:
Do you know one?  Please contribute it!

Documentation: CreateILockBytesOnHGlobal@msdn on MSDN