ICancelMethodCalls::Cancel メソッド (objidlbase.h)
メソッド呼び出しの取り消しを要求します。
構文
HRESULT Cancel(
[in] ULONG ulSeconds
);
パラメーター
[in] ulSeconds
クライアントが取り消しを要求した後、サーバーが送信呼び出しを完了するまで待機する秒数。
戻り値
このメソッドは、これらの値のいずれかを返すことができます。
| リターン コード | 説明 |
|---|---|
|
取り消し要求が行われました。 |
|
呼び出しは既に取り消されています。 |
|
呼び出しの取り消しは、呼び出しを処理しているスレッドでは有効になっていません。 |
|
呼び出しはタイムアウト間隔中に完了しました。 |
注釈
Cancel メソッドは 、 キャンセル要求のみを発行します。 戻り値S_OKは、呼び出しが取り消されたことを意味するわけではなく、呼び出しを取り消そうとしたという意味だけです。 取り消し要求を受け取った場合の cancel オブジェクトの動作は、実装者の裁量で行われます。
HRESULT を返すメソッドが取り消された場合、戻り値はRPC_S_CALL_CANCELEDされます。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | objidlbase.h (ObjIdl.h を含む) |