UnRegisterForPrintAsyncNotifications 関数 (prnasnot.h)
登録されているアプリケーションが、印刷スプーラーでホストされている印刷コンポーネントから未登録の通知を受信できるようにします。
構文
HRESULT UnRegisterForPrintAsyncNotifications(
[in] HANDLE unnamedParam1
);
パラメーター
[in] unnamedParam1
登録解除する登録ハンドル。
戻り値
HRESULT | 重大度 | 説明 |
---|---|---|
S_OK | SUCCESS | 関数は正常に終了しました。 |
ALREADY_UNREGISTERED |
SUCCESS ERROR |
登録ハンドラーは既に登録解除されています。 この HRESULT に ERROR 重大度がある場合、呼び出し元の関数はエラー条件を処理する必要があります。 |
NOT_REGISTERED | SUCCESS | 登録ハンドラーが登録されていません。 |
戻り値は COM エラー コードです。 この関数は操作を正常に完了しても、S_OK以外の HRESULT を返す可能性があるため、SUCCEEDED マクロまたは FAILED マクロを使用して、呼び出しの成功を確認する必要があります。 関数によって返された特定の HRESULT を取得するには、HRESULT_CODE マクロを使用します。
次のコード例は、これらのマクロを使用して戻り値を評価する方法を示しています。
if (SUCCEEDED(hr)) {
// Call succeeded, check HRESULT value returned
switch (HRESULT_CODE(hr)){
case S_OK:
// Some action
break;
case NOT_REGISTERED:
// Some action
break;
case ALREADY_UNREGISTERED:
// Some action
break;
default:
// Default action
break;
}
} else {
// Call failed, check HRESULT value returned
switch (HRESULT_CODE(hr)){
// This can be error and a successful return
case ALREADY_UNREGISTERED:
// Some action
break;
default:
// Default action
break;
}
}
COM エラー コードの詳細については、「エラー処理」を参照してください。
その他の可能な戻り値については、「 PrintAsyncNotifyError 」を参照してください。
注釈
チャネルが双方向の場合、 UnRegisterForPrintAsyncNotifications を呼び出すと、その時点以降に作成された通信チャネルからの通知のみが禁止されます。 既存のチャネルからの通知を終了するには、リッスンしているアプリケーションが IPrintAsyncNotifyChannel::CloseChannel を使用してチャネルを閉じる必要があります。
UnRegisterForPrintAsyncNotifications を呼び出すと、RegisterForPrintAsyncNotifications に渡される pCallback オブジェクトの参照カウントがデクリメントされます。
この関数が成功した後、 hRegistrationHandler は無効であり、再度使用することはできません。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows Vista [デスクトップ アプリのみ] |
サポートされている最小のサーバー | Windows Server 2008 [デスクトップ アプリのみ] |
対象プラットフォーム | Windows |
ヘッダー | prnasnot.h |
Library | WinSpool.lib |
[DLL] | Spoolss.dll |
こちらもご覧ください
フィードバック
https://aka.ms/ContentUserFeedback」を参照してください。
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「フィードバックの送信と表示