StgIsStorageILockBytes

Indicates whether the specified byte array contains a storage object.

WINOLEAPI StgIsStorageILockBytes(
  ILockBytes * plkbyt  //ILockBytes pointer to the byte array to be 
                       // examined
);
 

Parameter

plkbyt
ILockBytes pointer to the byte array to be examined.

Return Values

S_OK
Indicates the specified byte array contains a storage object.
S_FALSE
Indicates the specified byte array does not contain a storage object.

This function can also return any file system errors, or Win32 errors wrapped in an HRESULT, or ILockBytes interface error return values.

Remarks

At the beginning of the byte array underlying a storage object is a signature distinguishing a storage object (supporting the IStorage interface) from other file formats. The StgIsStorageILockBytes function is useful to applications whose documents use a byte array (a bye array object supports the ILockBytes interface) that might or might not use storage objects.

QuickInfo

  Windows NT: Use version 3.1 or later.
  Windows: Use Windows 95 or later.
  Windows CE: Unsupported.
  Header: Declared in objbase.h.
  Import Library: Included as a resource in ole32.dll.

See Also

StgIsStorageFile, ILockBytes