FmtIdToPropStgName

Converts a property set's format identifier to its storage or stream name.

HRESULT FmtIdToPropStgName(
  const FMTID* pfmtid,  //Pointer to the format identifier of the 
                        // property set
  LPOLESTR oszName      //Pointer to a string receiving the property 
                        // set name
);
 

Parameters

pfmtid
[in] Pointer to the format identifier of the property set.
oszName
[out] Pointer to a string that receives the storage or stream name of the property set identified by pfmtid. The array allocated for this string must be at least CCH_MAX_PROPSTG_NAME (32) characters in length.

Return Values

This function supports the standard return value E_INVALIDARG as well as the following:

S_OK
The storage or stream name of the property set was successfully returned.

Remarks

FmtIdToPropStgName maps a property set's format identifier to its stream name for a simple property set or to its storage name for a nonsimple property set.

This function is useful in creating or opening a property set using the PROPSETFLAG_UNBUFFERED value with the StgCreatePropStg and StgOpenPropStg functions. See the PROPSETFLAG enumeration for more information on the use of PROPSETFLAG_UNBUFFERED.

Programming Information

Windows NT 4.0/SP2 or with IPROP.DLL
Win95 Yes; requires IPROP.DLL
Win32s No
Unicode Yes
Import Library IPROP.DLL
Header File IPROPIDL.H

QuickInfo

  Windows NT: Use version 4.0 SP2 or later.
  Windows: Unsupported.
  Windows CE: Unsupported.
  Header: Declared in objidl.h.
  Import Library: Included as a resource in ole32.dll.

See Also

PROPSETFLAG, PropStgNameToFmtId, StgCreatePropStg, StgOpenPropStg