IPropertySheetProvider::CreatePropertySheet メソッド (mmc.h)

IPropertySheetProvider::CreatePropertySheet メソッドは、プロパティ シート フレームを作成します。

構文

HRESULT CreatePropertySheet(
  [in] LPCWSTR      title,
  [in] boolean      type,
  [in] MMC_COOKIE   cookie,
  [in] LPDATAOBJECT pIDataObjectm,
  [in] DWORD        dwOptions
);

パラメーター

[in] title

プロパティ ページのタイトルを含む null で終わる文字列へのポインター。 このパラメーターを NULL にすることはできません。

[in] type

TRUE を指定 するとプロパティ シートが作成され、 FALSE の 場合はウィザードが作成されます。

[in] cookie

現在選択されているアイテムの Cookie 値。 これは、CreatePropertySheet が拡張機能スナップインによって呼び出される場合に NULL にすることができます。

[in] pIDataObjectm

Cookie のデータ オブジェクトの IDataObject インターフェイスへのポインター。 このパラメーターの値が NULL の場合、MMC は拡張スナップインによって実装された IExtendPropertySheet2 メソッドを呼び出しません。

[in] dwOptions

メソッド呼び出しで設定できるフラグを指定する 値。 パラメーターには、次の値の組み合わせを指定できます。

MMC_PSO_NOAPPLYNOW

[今すぐ適用] ボタンを削除します。

MMC_PSO_HASHELP

[ヘルプの追加] ボタン。

MMC_PSO_NO_PROPTITLE

ウィザードでは無視されます。 プロパティ シートの場合、このオプションを指定すると、プロパティ シートのタイトル バーの先頭に "Properties for" という単語は挿入されません。

MMC_PSO_NEWWIZARDTYPE

ウィザード 97 スタイルを使用します。

たとえば、[ ヘルプ ] ボタンがあり、[今すぐ適用] ボタンがないプロパティ シートを作成するには、dwOptions パラメーターを にする MMC_PSO_NOAPPLYNOW | MMC_PSO_HASHELP必要があります。

戻り値

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

解説

このメソッドは、プロパティ シートの作成に必要なすべての情報を収集する オブジェクトを作成します。 CreatePropertySheet 呼び出しが成功したが、それ以降のエラーが発生した場合は、 IPropertySheetProvider::Show( –1, 0) を呼び出してオブジェクトを解放する必要があります。 この場合、戻りコードは無視できます。

スナップインが IPropertySheetProvider::CreatePropertySheet の呼び出しでプロパティ シートを作成し、必要に応じて IPropertySheetProvider::AddPrimaryPages と IPropertySheetProvider::AddExtensionPages を呼び出す場合は、 プロパティ シートを表示しない場合は、 IPropertySheetProvider::Show( –1, 0) を呼び出してプロパティ シートを削除し、そのリソースを解放する必要があります。 この場合、スナップインは、作成したプロパティ ページ ハンドルを削除する必要があります。 これは、スナップインが IPropertySheetProvider::Show( –1, 0) を呼び出す前または後に実行できます。MMC ではプロパティ ページ ハンドルが使用されないためです。

MMC 1.1 を対象とするスナップインの場合、スナップインは IPropertySheetProvider::CreatePropertySheet 呼び出しで MMC に渡す IDataObject インターフェイスに対する追加の参照を保持する必要があります。 この参照は 、IPropertySheetProvider::CreatePropertySheet 呼び出しの前から、プロパティ シートが IPropertySheetProvider::Show( –1, 0) の呼び出しで閉じられるまで保持する必要があります。

要件

サポートされている最小のクライアント	Windows Vista
サポートされている最小のサーバー	Windows Server 2008
対象プラットフォーム	Windows
ヘッダー	mmc.h
[DLL]	Mmcndmgr.dll

関連項目

Idataobject

IPropertySheetProvider

IPropertySheetProvider::Show