IPersistFolder3::InitializeEx 메서드(shobjidl_core.h)

폴더를 초기화하고 네임스페이스에서 해당 위치를 지정합니다. 폴더가 바로 가기인 경우 이 메서드는 대상 폴더의 위치도 지정합니다.

구문

HRESULT InitializeEx(
  [in] IBindCtx                         *pbc,
  [in] PCIDLIST_ABSOLUTE                pidlRoot,
  [in] const PERSIST_FOLDER_TARGET_INFO *ppfti
);

매개 변수

[in] pbc

형식: IBindCtx*

바인딩 컨텍스트를 제공하는 IBindCtx 개체에 대한 포인터입니다. 이 매개 변수는 NULL일 수 있습니다.

[in] pidlRoot

형식: LPCITEMIDLIST

폴더 또는 폴더 바로 가기의 절대 위치를 지정하는 정규화된 PIDL에 대한 포인터입니다. 호출 애플리케이션은 이 PIDL을 할당하고 해제합니다.

[in] ppfti

형식: const PERSIST_FOLDER_TARGET_INFO*

대상 폴더의 위치와 해당 특성을 지정하는 PERSIST_FOLDER_TARGET_INFO 구조체에 대한 포인터입니다.

ppfti가 유효한 구조를 가리키는 경우 pidlRoot는 폴더 바로 가기를 나타냅니다.

ppfti가 NULL로 설정된 경우 pidlRoot는 일반 폴더를 나타냅니다. 이 경우 InitializeEx 는 Initialize 가 호출된 것처럼 동작해야 합니다.

반환 값

형식: HRESULT

메서드가 성공하면 S_OK를 반환하고, 그러지 않으면 HRESULT 오류 코드를 반환합니다.

설명

이 함수는 IPersistFolder::Initialize의 확장 버전입니다. 이를 통해 셸은 일반 폴더뿐만 아니라 폴더 바로 가기를 초기화할 수 있습니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 Professional SP3, Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	shobjidl_core.h(Shobjidl.h 포함)
DLL	Shell32.dll(버전 5.0 이상)