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 を含む) |