RpcServerTestCancel 関数 (rpcdce.h)

[アーティクル]
03/09/2024

サーバーは RpcServerTestCancel を呼び出して、クライアントの取り消し要求をテストします。

構文

RPC_STATUS RpcServerTestCancel(
  RPC_BINDING_HANDLE BindingHandle
);

パラメーター

BindingHandle

を呼び出して、キャンセルコマンドをテストします。値 0 を指定すると、サーバーは、このサーバースレッドによって処理されるクライアントを偽装します。

戻り値

値	意味
RPC_S_OK	クライアントによって呼び出しが取り消されました。サーバーは引き続き呼び出しを完了または中止する必要があります。
RPC_S_NO_CALL_ACTIVE	現在のスレッドでアクティブな呼び出しはありません。
RPC_S_CALL_IN_PROGRESS	呼び出しは取り消されませんでした。
RPC_S_INVALID_BINDING	ハンドルが無効です。

メモ有効なエラーコードの一覧については、「 RPC 戻り値」を参照してください。

注釈

サーバーは RpcServerTestCancel を呼び出して、クライアントが未処理の呼び出しのキャンセルを要求したかどうかを確認します。 RpcServerTestCancel 関数は、クライアントが呼び出しを取り消したかどうかを示すだけです。状態は、サーバーまたはクライアントでは変更されません。取り消された呼び出しは、 RpcAsyncCompleteCall 関数呼び出しまたは RpcAsyncAbortCall 関数呼び出しをそれぞれ使用して、RPC サーバーによって完了または中止される必要があります。

BindingHandle パラメーターは、テストする呼び出しを指定します。パラメーターの値が 0 の場合、現在のスレッドでの呼び出しがテストされます。サーバーは RpcServerTestCancel(RpcAsyncGetCallHandle(pAsync)) 関数を呼び出して、非同期ハンドルを使用してバインディングハンドルを取得するキャンセルメッセージをテストできます。

要件

要件	値
サポートされている最小のクライアント	Windows 2000 Professional [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップアプリのみ]
対象プラットフォーム	Windows
ヘッダー	rpcdce.h (Rpc.h を含む)
Library	Rpcrt4.lib
[DLL]	Rpcrt4.dll