PSM_GETRESULT メッセージ

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

パラメーター

wParam

ゼロを指定してください。

lParam

ゼロを指定してください。

戻り値

成功した場合は正の値を返し、それ以外の場合は -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 を返します。 その後、モーダル プロパティ シートが PropertySheet から受け取った値を取得するには、 PSM_GETRESULT メッセージを送信します。

Note

このメッセージは、Aero ウィザード スタイル (PSH_AEROWIZARD) を使用する場合はサポートされません。

要件

要件	値
サポートされている最小のクライアント	Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2003 [デスクトップ アプリのみ]
ヘッダー	Prsht.h