ICancelMethodCalls::Cancel メソッド (objidl.h)

メソッド呼び出しの取り消しを要求します。

構文

HRESULT Cancel(
  [in] ULONG ulSeconds
);

[in] ulSeconds

クライアントが取り消しを要求した後、サーバーが送信呼び出しを完了するまで待機する秒数。

このメソッドは、これらの値のいずれかを返すことができます。

リターンコード	説明
S_OK	取り消し要求が行われました。
RPC_S_CALL_CANCELED	呼び出しは既に取り消されています。
CO_E_CANCEL_DISABLED	呼び出しの取り消しは、呼び出しを処理しているスレッドでは有効になっていません。
RPC_E_CALL_COMPLETE	呼び出しはタイムアウト間隔中に完了しました。

Cancel メソッドは、キャンセル要求のみを発行します。戻り値S_OKは、呼び出しが取り消されたことを意味するわけではなく、呼び出しを取り消そうとしたという意味だけです。取り消し要求を受け取った場合の cancel オブジェクトの動作は、実装者の裁量で行われます。

HRESULT を返すメソッドが取り消された場合、戻り値はRPC_S_CALL_CANCELEDされます。

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