IPropertySheetProvider::FindPropertySheet

[This is preliminary documentation and subject to change.]

Determines whether a specific property sheet exists.

HRESULT FindPropertySheet(
  long cookie,  // Managed object's cookie
  LPCOMPONENT lpComponent,
                // Pointer to the component that owns the cookie
  LPDATAOBJECT lpDataObject
                // Pointer to the data object for the cookie
);
 

Parameter

cookie

[in] Identifies the managed object that is about to have a property sheet displayed.

lpComponent

[in] Pointer to the IComponent interface on the object that owns the cookie. NULL if the object selected is a folder (on the scope or result panes), and the snapin's IComponent if it is a result pane leaf item.

lpDataObject

[in] Pointer to the IDataObject interface on the data object for the cookie.

Return Values

S_OK

The property sheet was successfully located and was brought to the foreground.

S_FALSE

A property sheet with this cookie was not found.

Remarks

Items in the scope pane are owned by the console so there is no need to interact with the IComponentData interface. The snap-in must implement IComponent::CompareObjects or IComponentData::CompareObjects to compare the data object for this cookie with all other cookies for existing property sheets.

See Also

IPropertySheetProvider