PSM_GETRESULT メッセージ
PropertySheet によってモーダル プロパティ シートに返される情報を取得するために、モードレス プロパティ シートで使用されます。 このメッセージは明示的に送信することも、 PropSheet_GetResult マクロを使用することもできます。
パラメーター
-
wParam
-
ゼロを指定してください。
-
lParam
-
ゼロを指定してください。
戻り値
成功した場合は正の値を返し、それ以外の場合は -1 を返します。 次の戻り値は特別な意味を持ちます。
リターン コード | 説明 |
---|---|
|
ページがプロパティ シートに PSM_REBOOTSYSTEM メッセージを送信しました。 ユーザーの変更を有効にするには、コンピューターを再起動する必要があります。 |
|
ページがプロパティ シートに 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 [デスクトップ アプリのみ] |
ヘッダー |
|