ITransferAdviseSink::P ropertyFailure 메서드(shobjidl_core.h)

파일 속성과 사용자 상호 작용이 필요한 오류가 있을 때 호출됩니다.

구문

HRESULT PropertyFailure(
  [in] IShellItem        *psi,
  [in] const PROPERTYKEY *pkey,
  [in] HRESULT           hrError
);

[in] psi

오류를 발생시킨 IShellItem 에 대한 포인터입니다.

[in] pkey

형식: const PROPERTYKEY*

손실될 속성에 해당하는 값입니다. NULL 값은 모든 속성이 손실되었음을 나타냅니다.

[in] hrError

형식: HRESULT

오류로 인해 생성된 오류 코드입니다. 복사 엔진에서 처리해야 합니다.

형식: HRESULT

다른 모든 HRESULT 를 전달해야 합니다. 오류가 처리되지 않으면 반환 값은 hrError여야 합니다.

반환 코드	설명
COPYENGINE_S_USERRETRY	처리기는 파일 작업을 다시 시도해야 합니다.
COPYENGINE_S_USERRETRYWITHNEWNAME	처리기는 pszRename 버퍼에서 반환된 이름을 사용하여 파일 작업을 다시 시도해야 합니다.
COPYENGINE_S_OVERWRITE	사용자가 처리기가 기존 파일을 덮어써야 한다고 표시했습니다.
COPYENGINE_S_RETRYWITHOUTSECURITY	사용자는 처리기가 보안 설명자 없이 작업을 다시 시도해야 한다고 표시했습니다.
COPYENGINE_E_USERCANCELLED	사용자가 취소를 클릭했습니다. 전체 복사 작업이 종료됩니다. 처리기는 이 코드를 복사 엔진으로 다시 반환해야 합니다.