IPerPropertyBrowsing::MapPropertyToPage

Returns the CLSID of the property page associated with the specified property. In other words, this method maps a specified property to the property page that allows a user to manipulate that property. The CLSID returned from this method can be passed to OleCreatePropertyFrameIndirect to specify the initial page to display in the property sheet.

HRESULT MapPropertyToPage(
  DISPID dispID ,  //Dispatch identifier for the property
  CLSID *pclsid    //Receives a pointer to CLSID for property
);
 

Parameters

dispID

[in] Dispatch identifier of the property of interest.

pclsid

[out] Pointer to the CLSID identifying the property page associated with the property specified by dispID. If this method fails, *pclsid is set to CLSID_NULL.

Return Values

This method supports the standard return values E_INVALIDARG and E_UNEXPECTED, as well as the following:

S_OK

The CLSID was successfully returned.

E_NOTIMPL

The object does not support property pages at all or doesn't support mapping properties to the page CLSID. In other words, this feature of specific property browsing is not supported.

E_POINTER

The address in pclsid is not valid. For example, it may be NULL.

QuickInfo

  Windows NT: Use version 4.0 or later.
  Windows: Use Windows 95 or later.
  Windows CE: Unsupported.
  Header: Declared in ocidl.h.