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는 오류를 나타냅니다.

반환 코드	Description
S_OK	인터페이스가 성공적으로 연결되었습니다.
E_UNEXPECTED	처리기는 하나의 싱크 인터페이스만 처리할 수 있습니다.

설명

처리기가 발생할 수 있는 오류를 콜백할 수 있도록 다른 ITransferDestination 메서드를 호출하기 전에 ITransferDestination::Advise를 호출합니다. 설정되지 않은 경우 처리기는 피드백을 사용할 수 없음을 나타내는 것으로 간주하고 "기본값" 작업을 수행해야 합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2008 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	shobjidl_core.h(Shobjidl.h 포함)