IIOCancelInformation::SetCancelInformation メソッド (shobjidl_core.h)

ユーザーが進行状況 UI から [キャンセル ] を選択したときに投稿される情報を設定します。 ユーザーが [キャンセル] をクリックしたときに進行状況ダイアログがプロセス スレッドにメッセージ ID を送信できるように、メイン オブジェクトがプロセス スレッドについて進行状況ダイアログ スレッドに通知できるようにします。

構文

HRESULT SetCancelInformation(
  [in] DWORD dwThreadID,
  [in] UINT  uMsgCancel
);

パラメーター

[in] dwThreadID

型: DWORD

取り消されるプロセス スレッドの ID。

[in] uMsgCancel

型: UINT

スレッドに投稿するキャンセル メッセージ。

戻り値

種類: HRESULT

このメソッドは、成功すると S_OK を返します。 そうでない場合は、HRESULT エラー コードを返します。

解説

ユーザーが進行状況 UI から [キャンセル ] を選択すると、 dwThreadID は保留中または将来の入出力 (I/O) 要求を取り消します。 また、進行状況ダイアログから受信した uMsgCancel メッセージはスレッドに投稿され、非同期 I/O が保留中の場合は待機状態を終了するように指示されます。

要件

サポートされている最小のクライアント	Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2008 [デスクトップ アプリのみ]
対象プラットフォーム	Windows
ヘッダー	shobjidl_core.h (Shobjidl.h を含む)
[DLL]	Shell32.dll