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 포함) |