ReadClassStm

Reads the CLSID previously written to a stream object with the WriteClassStm method.

WINOLEAPI ReadClassStm(
  IStream * pStm, //Pointer to the stream holding the CLSID
  CLSID * pclsid  //Pointer to where the CLSID is to be written
);
 

Parameters

pStm

[in] Pointer to the IStream interface on the stream object containing the CLSID to be read. This CLSID must have been previously written to the stream object using WriteClassStm.

pclsid

[out] Pointer to where the CLSID is to be written.

Return Values

S_OK

The CLSID was successfully retrieved.

STG_E_READFAULT

End of file was reached.

This function also returns any of the error values returned by the ISequentialStream::Read method.

Remarks

Most applications do not call the ReadClassStm method directly. OLE calls it before making a call to an object's IPersistStream::Load implementation.

Windows CE: Passing into this function any invalid and, under some circumstances, NULL pointers will result in unexpected termination of the application. For more information about handling exceptions, see Programming Considerations.

QuickInfo

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

See Also

WriteClassStm, ReadClassStg, WriteClassStg