SHOpenPropSheetA 関数 (shlobj.h)

[SHOpenPropSheet は、[要件] セクションで指定されたオペレーティング システムで使用できます。 それ以降のバージョンでは、変更または使用できない可能性があります。

個々のシートの CLSIDを含むレジストリ キーの一覧からプロパティ シートを作成し、プロパティ シートを開きます。

構文

BOOL SHOpenPropSheetA(
  [in, optional] LPCSTR        pszCaption,
  [in, optional] HKEY []       ahkeys,
                 UINT          ckeys,
  [in, optional] const CLSID   *pclsidDefault,
  [in]           IDataObject   *pdtobj,
  [in, optional] IShellBrowser *psb,
  [in, optional] LPCSTR        pStartPage
);

パラメーター

[in, optional] pszCaption

型: LPCTSTR

プロパティ シートのキャプションを含む文字列へのポインター。 キャプションが不要な場合、この値は NULL できます。

[in, optional] ahkeys

型: HKEY[]

個々のプロパティ シートの CLSIDを表すレジストリ キーの配列。

ckeys

型: UINT

ahkeysで指定された配列内のプロパティ シートの数を指定する UINT 値を します。

[in, optional] pclsidDefault

型: const CLSID*

既定の CLSIDへのポインター。 この値は NULLできます。

[in] pdtobj

型: IDataObject*

IDataObjectへのポインター。プロパティ シートに対するアクションを実行するために使用できる OLE オブジェクトです。

[in, optional] psb

型: IShellBrowser*

使用されません。

[in, optional] pStartPage

型: LPCTSTR

開始ページを指定する文字列へのポインター。 この値は NULLできます。

戻り値

型: BOOL

プロパティ シートが正常に作成された場合 TRUE を返します。それ以外の場合は、FALSEを します。

備考

手記

shlobj.h ヘッダーは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして SHOpenPropSheet を定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。

必要条件

要件	価値
サポートされる最小クライアント	Windows XP [デスクトップ アプリのみ]
サポートされる最小サーバー	Windows Server 2003 [デスクトップ アプリのみ]
ターゲット プラットフォーム の	ウィンドウズ
ヘッダー	shlobj.h
ライブラリ	Shell32.lib
DLL	Shell32.dll (バージョン 5.0 以降)