RpcServerTestCancel 関数 (rpcdce.h)
サーバーは RpcServerTestCancel を呼び出して、クライアントの取り消し要求をテストします。
構文
RPC_STATUS RpcServerTestCancel(
RPC_BINDING_HANDLE BindingHandle
);
パラメーター
BindingHandle
を呼び出して、キャンセル コマンドをテストします。 値 0 を指定すると、サーバーは、このサーバー スレッドによって処理されるクライアントを偽装します。
戻り値
| 値 | 意味 |
|---|---|
|
クライアントによって呼び出しが取り消されました。 サーバーは引き続き呼び出しを完了または中止する必要があります。 |
|
現在のスレッドでアクティブな呼び出しはありません。 |
|
呼び出しは取り消されませんでした。 |
|
ハンドルが無効です。 |
メモ 有効なエラー コードの一覧については、「 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 |