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

ファイル操作の状態に関する通知のアドバイザリ接続を設定します。

構文

HRESULT Advise(
  [in]  ITransferAdviseSink *psink,
  [out] DWORD               *pdwCookie
);

パラメーター

[in] psink

種類: ITransferAdviseSink*

このインターフェイスのメソッドを使用して呼び出し元のアプリケーションを更新するための ITransferAdviseSink 通知インターフェイスへのポインター。

[out] pdwCookie

種類: DWORD*

この接続を一意に識別する、返されたトークンへのポインター。 呼び出し元のアプリケーションは、後でこのトークンを使用して、 接続を ITransferDestination::Unadvise メソッドに渡すことで接続を削除します。 接続が正常に確立されない場合、この値は 0 です。

戻り値

種類: HRESULT

一覧に記載されていない HRESULT は、エラーを示します。

注釈

他 の ITransferDestination メソッドを呼び出す前に ITransferDestination ::Advise を呼び出して、発生する可能性のあるエラーをハンドラーがコールバックできるようにします。 設定されていない場合、ハンドラーはフィードバックがないことを示すものと見なし、"既定" 操作を実行する必要があります。

要件