IKnownFolderManager::Redirect 메서드(shobjidl_core.h)

일반 및 사용자별 폴더에 대한 폴더 요청을 리디렉션합니다.

구문

HRESULT Redirect(
  [in]           REFKNOWNFOLDERID    rfid,
  [in, optional] HWND                hwnd,
  [in]           KF_REDIRECT_FLAGS   flags,
  [in, optional] LPCWSTR             pszTargetPath,
  [in]           UINT                cFolders,
  [in]           const KNOWNFOLDERID *pExclusion,
  [out]          LPWSTR              *ppszError
);

매개 변수

[in] rfid

형식: REFKNOWNFOLDERID

리디렉션할 폴더의 KNOWNFOLDERID 에 대한 참조입니다.

[in, optional] hwnd

형식: HWND

flags 매개 변수에 KF_REDIRECT_WITH_UI 전달될 때 복사 엔진 진행률 UI 대화 상자를 표시하는 데 사용되는 부모 창의 핸들입니다. 진행률 대화 상자가 필요하지 않은 경우 이 값은 NULL일 수 있습니다.

[in] flags

형식: KF_REDIRECT_FLAGS

리디렉션에 대한 KF_REDIRECT_FLAGS 옵션입니다.

[in, optional] pszTargetPath

형식: LPCWSTR

폴더의 새 경로에 대한 포인터입니다. null로 끝나는 유니코드 문자열입니다. 이 값은 NULL일 수 있습니다.

[in] cFolders

형식: UINT

pExclusion의 배열에 있는 KNOWNFOLDERID 값의 수입니다.

[in] pExclusion

형식: KNOWNFOLDERID const*

리디렉션에서 제외해야 하는 rfid의 하위 폴더를 참조하는 KNOWNFOLDERID 값 배열에 대한 포인터입니다. 제외된 하위 폴더가 없는 경우 이 값은 NULL일 수 있습니다.

[out] ppszError

형식: LPWSTR*

이 메서드가 반환될 때 가 생성된 경우 오류 메시지가 포함된 null로 종료된 유니코드 문자열에 대한 포인터의 주소를 포함합니다. 이 값은 NULL일 수 있습니다.

반환 값

형식: HRESULT

성공하면 S_OK 반환하고, 그렇지 않으면 다음을 포함하여 오류 값을 반환합니다.

반환 코드	설명
E_INVALIDARG	무엇보다도 이 값은 rfid 매개 변수가 시스템에 없는 KNOWNFOLDERID 를 참조함을 나타낼 수 있습니다. 모든 KNOWNFOLDERID 값이 모든 시스템에 있는 것은 아닙니다. IKnownFolderManager::GetFolderIds를 사용하여 현재 시스템에 대한 KNOWNFOLDERID 값 집합을 검색합니다.

요구 사항

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

추가 정보

IKnownFolderManager

알려진 폴더 샘플