WriteFmtUserTypeStg

Writes a clipboard format and user type to the storage object.

WINOLEAPI WriteFmtUserTypeStg(

IStorage * pStg,

//Points to the IStorage interface on the storage object

CLIPFORMAT cf,

//Specifies the clipboard format

LPWSTR * lpszUserType

//Points to the current user type

);

Parameters

pStg: [in] IStorage pointer to the storage object where the information is to be written.
cf: [in] Specifies the clipboard format that describes the structure of the native area of the storage object. The format tag includes the policy for the names of streams and substorages within this storage object and the rules for interpreting data within those streams.
lpszUserType: [in] Points to the object’s current user type. It cannot be NULL. This is the type returned by the IOleObject::GetUserType method. If this function is transported to a remote machine where the object class does not exist, this persistently stored user type can be shown to the user in dialog boxes.

Return Values

S_OK: Indicates the information was written successfully.
STG_E_MEDIUMFULL: Indicates information could not be written due to lack of space on the storage medium.

IStream::Write method error return values.

Remarks

The WriteFmtUserTypeStg function must be called in an object’s implementation of the IPersistStorage::Save method. It must also be called by document-level objects that use structured storage for their persistent representation in their save sequence.

To read the information saved, applications call the ReadFmtUserTypeStg function.

IStorage * pStg,	//Points to the IStorage interface on the storage object
CLIPFORMAT cf,	//Specifies the clipboard format
LPWSTR * lpszUserType	//Points to the current user type
);