次の方法で共有


RpcServerTestCancel 関数 (rpcdce.h)

サーバーは 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

こちらもご覧ください

非同期 RPC

RPC_ASYNC_STATE

RpcAsyncAbortCall

RpcAsyncCancelCall

RpcAsyncCompleteCall

RpcAsyncGetCallHandle

RpcAsyncGetCallStatus

RpcAsyncInitializeHandle