SHRunControlPanel 関数 (shlobj.h)

コントロール パネル項目を開きます。

メモ この関数は、Windows Vista の時点ではサポートされていません

 

構文

BOOL SHRunControlPanel(
  [in]           PCWSTR lpcszCmdLine,
  [in, optional] HWND   hwndMsgParent
);

パラメーター

[in] lpcszCmdLine

種類: PCWSTR

コントロール パネル項目を開くコマンド ラインを含む文字列へのポインター。 このコマンド ラインには、少なくとも .cpl ファイルの名前が含まれています。 また、アイテム内のプロパティ シート ページなどの他の必要な情報 (序数または名前) を含めることもできます。 詳細については、「コントロール パネル項目の実行」を参照してください。

[in, optional] hwndMsgParent

型: HWND

アイテムの開始に関するエラー メッセージを表示するために使用される親ウィンドウのハンドル。 この値には NULL を指定できます。

戻り値

種類: BOOL

コントロール パネル項目が正常に開かれた場合は TRUE、それ以外の場合は FALSE。

Windows Vista の時点では、この関数は常に FALSE を返します。

解説

指定したコントロール パネル項目が既に実行されている場合、SHRunControlPanel は新しいインスタンスを開くのではなく、そのインスタンスに切り替えようとします。

例

SHRunControlPanel の呼び出しの例を次に示します。

SHRunControlPanel(TEXT("timedate.cpl"), hwnd);
SHRunControlPanel(L"appwiz.cpl", NULL);
SHRunControlPanel(L"appwiz.cpl,2", NULL);
SHRunControlPanel("desk.cpl,Settings", hwnd

要件

サポートされている最小のクライアント	SP1 を使用した Windows XP [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム	Windows
ヘッダー	shlobj.h
[DLL]	Shell32.dll