SHOpenFolderAndSelectItems 함수(shlobj_core.h)

아티클
08/26/2023

특정 폴더에 지정된 항목이 선택된 Windows Explorer 창을 엽니다.

구문

SHSTDAPI SHOpenFolderAndSelectItems(
  [in]           PCIDLIST_ABSOLUTE     pidlFolder,
                 UINT                  cidl,
  [in, optional] PCUITEMID_CHILD_ARRAY apidl,
                 DWORD                 dwFlags
);

매개 변수

[in] pidlFolder

형식: PCIDLIST_ABSOLUTE

폴더를 지정하는 정규화된 항목 ID 목록에 대한 포인터입니다.

cidl

형식: UINT

선택 배열의 항목 수( apidl)입니다. cidl이 0이면 pidlFolder는 선택할 단일 항목을 설명하는 완전히 지정된 ITEMIDLIST를 가리킵니다. 이 함수는 부모 폴더를 열고 해당 항목을 선택합니다.

[in, optional] apidl

형식: PCUITEMID_CHILD_ARRAY

PIDL 구조체 배열에 대한 포인터로, 각각 pidlFolder에서 참조하는 대상 폴더에서 선택할 항목입니다.

dwFlags

형식:DWORD

선택적 플래그입니다. Windows XP에서 이 매개 변수는 무시됩니다. Windows Vista에서는 다음 플래그가 정의됩니다.

OFASI_EDIT(0x0001)

항목을 선택하고 해당 이름을 편집 모드로 전환합니다. 이 플래그는 단일 항목을 선택할 때만 사용할 수 있습니다. 여러 항목 선택 항목의 경우 무시됩니다.

OFASI_OPENDESKTOP(0x0002)

Windows Explorer 창이 아닌 바탕 화면에서 항목 또는 항목을 선택합니다. 열린 창 뒤에 바탕 화면이 가려지면 표시되지 않습니다.

반환 값

형식: HRESULT

이 함수가 성공하면 S_OK 반환합니다. 그러지 않으면 HRESULT 오류 코드를 반환합니다.

설명

SHOpenFolderAndSelectItems를 사용하기 전에 CoInitialize 또는 CoInitializeEx를 호출해야 합니다. 이렇게 하지 않을 경우 SHOpenFolderAndSelectItems가 실패합니다 .

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	shlobj_core.h(Shlobj.h 포함)
라이브러리	Shell32.lib
DLL	Shell32.dll(버전 6.0 이상)

다음을 통해 공유