PropStgNameToFmtId

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

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

Parameters

oszName
[in] Pointer to a string containing the stream name of a simple property set or the storage name of a nonsimple property set.
pfmtid
[out] Pointer to a FMTID variable that receives the format identifier of the property set specified by oszName.

Return Values

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

S_OK
The format identifier of the property set was successfully returned.
STG_E_INVALIDNAME
The oszName parameter was invalid.

Remarks

ProgStgNameToFmtId maps a simple property set's stream name or a non-simple property set's storage name to its format identifier.

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

FmtIdToPropStgName, PROPSETFLAG, StgCreatePropStg, StgOpenPropStg