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.