IFileOperation::Advise メソッド (shobjidl_core.h)

  • [アーティクル]

ハンドラーがすべての操作の状態とエラー情報を提供できるようにします。

構文

HRESULT Advise(
  [in]  IFileOperationProgressSink *pfops,
  [out] DWORD                      *pdwCookie
);

パラメーター

[in] pfops

種類: IFileOperationProgressSink*

進行状況とエラー通知に使用する IFileOperationProgressSink オブジェクトへのポインター。

[out] pdwCookie

種類: DWORD*

このメソッドが返されると、このパラメーターは、この接続を一意に識別する返されたトークンを指します。 呼び出し元のアプリケーションは、後でこのトークンを使用して、 接続を IFileOperation::Unadvise に渡すことで接続を削除します。 Advise の呼び出しが失敗した場合、この値は意味がありません。

戻り値

種類: HRESULT

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

注釈

いくつかの個別のメソッドには、独自の進行状況シンクを宣言する機能があります。このシンクは、ここで設定されたものと冗長です。 これらは、特定の操作の進行状況とエラー情報のみを指定する場合に使用されます。

要件

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

こちらもご覧ください

IFileOperation

IFileOperation::Unadvise