IExtendPropertySheet::CreatePropertyPages メソッド (mmc.h)

プロパティ シートにページを追加します。

構文

HRESULT CreatePropertyPages(
  [in] LPPROPERTYSHEETCALLBACK lpProvider,
  [in] LONG_PTR                handle,
  [in] LPDATAOBJECT            lpIDataObject
);

パラメーター

[in] lpProvider

IPropertySheetCallback インターフェイスへのポインター。

[in] handle

MMCN_PROPERTY_CHANGE通知メッセージを適切な IComponent または IComponentData インターフェイスにルーティングするために使用されるハンドルを示す 値です。

IPropertySheetProvider インターフェイスを直接使用するスナップインの場合、スナップインが IPropertySheetProvider::AddPrimaryPages を呼び出し、bCreateHandle を TRUE に指定すると、MMC によってハンドルが作成されます。

[in] lpIDataObject

スコープまたは結果項目に関するコンテキスト情報を含むオブジェクトの IDataObject インターフェイスへのポインター。

戻り値

このメソッドは、これらの値のいずれかを返すことができます。

解説

IPropertySheetCallback インターフェイスは、このメソッドの呼び出し中にスナップインに渡されます。 このインターフェイスの有効期間は MMC の制御下にあります。 そのため、ポインター lpIDataObject は、このメソッドの即時呼び出しの有効期間中にのみ有効です。 lpIDataObject ポインター値をコールバックの外部にキャッシュすることはお勧めしません。

API 関数 MMCPropertyChangeNotify を使用してプロパティの変更を親に通知するには、handle パラメーターで指定されたハンドルをプロパティ ページ オブジェクトに保存する必要があります。

スナップインが CreatePropertyPages から成功コード (S_OK、S_FALSE) を返す場合、スナップインは MMCFreeNotifyHandle を呼び出す必要があります。 スナップインからエラー コードが返された場合、MMC はハンドルをすぐに解放します。 MMCFreeNotifyHandle を呼び出すタイミングの詳細については、「 MMCFreeNotifyHandle」を参照してください。

要件

関連項目

プロパティ ページとウィザード ページの追加

IExtendPropertySheet

IPropertySheetCallback

MMCFreeNotifyHandle