PropSheet_GetResult マクロ (prsht.h)

  • [アーティクル]

PropertySheetによってモーダル プロパティ シートに返される情報を取得するために、モードレス プロパティ シート 使用されます。 このマクロを使用することも、PSM_GETRESULT メッセージを明示的に送信することもできます。

構文

int PropSheet_GetResult(
   HWND hDlg
);

パラメーター

hDlg

型: HWND

プロパティ シートのダイアログ ボックスを処理します。

戻り値

型: int

成功した場合は正の値を返し、それ以外の場合 -1 返します。 次の戻り値は特別な意味を持ちます。

リターン コード 形容
ID_PSREBOOTSYSTEM ページがプロパティ シートにPSM_REBOOTSYSTEM メッセージを送信しました。 ユーザーの変更を有効にするには、コンピューターを再起動する必要があります。
ID_PSRESTARTWINDOWS ページがプロパティ シートにPSM_RESTARTWINDOWSメッセージを送信しました。 ユーザーの変更を有効にするには、Windows を再起動する必要があります。

備考

拡張エラー情報を取得するには、GetLastError呼び出します。

戻り値は、propertySheet がモーダル プロパティ シートであった場合に返される と同じです。

バージョン 5.80。 PropertySheet 戻り値には、モーダル プロパティ シートとモードレス プロパティ シートに関するさまざまな情報が含まれます。 場合によっては、モードレス プロパティ シートがモーダルであった場合に、PropertySheet から受け取った情報が必要になる場合があります。 特に、ID_PSREBOOTSYSTEMまたはID_PSRESTARTWINDOWSが返されたかどうかを知る必要がある場合があります。

モードレス プロパティ シートの場合、メッセージ ループは PSM_ISDIALOGMESSAGE を使用してプロパティ シート ダイアログ ボックスにメッセージを渡し、PSM_GETCURRENTPAGEHWND してダイアログ ボックスを破棄するタイミングを決定する必要があります。 ユーザーが [OK] をクリックするか、[キャンセル] ボタン クリックすると、PSM_GETCURRENTPAGEHWND は NULL返します。 その後、PSM_GETRESULT メッセージを送信することで、モーダル プロパティ シートが propertySheet から受け取った値 取得できます。

注 Aero ウィザード スタイル (PSH_AEROWIZARD) を使用する場合、このマクロはサポートされていません。
 

必要条件

要件 価値
サポートされる最小クライアント Windows Vista [デスクトップ アプリのみ]
サポートされる最小サーバー Windows Server 2003 [デスクトップ アプリのみ]
ターゲット プラットフォーム の ウィンドウズ
ヘッダー prsht.h