ITransferAdviseSink::FileFailure 메서드(shobjidl_core.h)

오류가 있고 사용자 상호 작용이 필요할 때 호출됩니다.

구문

HRESULT FileFailure(
  [in]      IShellItem *psi,
  [in]      LPCWSTR    pszItem,
  [in]      HRESULT    hrError,
  [in, out] LPWSTR     pszRename,
  [in]      ULONG      cchRename
);

매개 변수

[in] psi

형식: IShellItem*

작업이 실패한 IShellItem 입니다.

[in] pszItem

형식: LPCWSTR

선택 사항입니다. 파일 이름을 포함하는 null로 끝나는 버퍼에 대한 포인터입니다. 이 값이 NULL이면 psi 매개 변수에서 지정한 이름이 사용됩니다.

[in] hrError

형식: HRESULT

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

[in, out] pszRename

형식: LPWSTR

선택 사항입니다. 이 메서드가 반환될 때 는 파일의 새 이름을 포함하는 null로 끝나는 버퍼에 대한 포인터를 포함합니다. 이름은 cchRename 길이를 초과할 수 없습니다. 이 매개 변수가 NULL인 경우 이름 바꾸기 옵션을 사용할 수 없습니다.

[in] cchRename

형식: ULONG

pszRename 버퍼의 크기(문자)입니다.

반환 값

형식: HRESULT

다른 모든 HRESULT 는 호출 프로세스에 반환되어야 합니다. 오류가 처리되지 않으면 반환 값은 hrError여야 합니다.

반환 코드	설명
COPYENGINE_S_USER_RETRY	사용자가 다시 시도를 클릭했습니다. 처리기는 파일 작업을 다시 시도해야 합니다.
COPYENGINE_E_USERCANCELLED	사용자가 취소를 클릭했습니다. 전체 복사 작업이 종료됩니다. 처리기는 이 코드를 복사 엔진으로 다시 반환해야 합니다.
COPYENGINE_S_USER_IGNORED	사용자가 무시를 클릭했습니다. 처리기는 항목 만들기를 건너뛰고 이 코드를 복사 엔진으로 다시 반환해야 합니다.

요구 사항

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