SHCreateShellItem 함수(shlobj_core.h)

IShellItem 개체를 만듭니다.

참고 이 함수 대신 SHCreateItemWithParent 또는 SHCreateItemFromIDList 를 사용하는 것이 좋습니다.

 

구문

SHSTDAPI SHCreateShellItem(
  [in, optional] PCIDLIST_ABSOLUTE pidlParent,
  [in, optional] IShellFolder      *psfParent,
  [in]           PCUITEMID_CHILD   pidl,
  [out]          IShellItem        **ppsi
);

매개 변수

[in, optional] pidlParent

형식: PCIDLIST_ABSOLUTE

부모에 대한 PIDL입니다. 이 값은 NULL일 수 있습니다.

[in, optional] psfParent

형식: IShellFolder*

부모 IShellFolder에 대한 포인터입니다. 이 값은 NULL일 수 있습니다.

[in] pidl

형식: PCUITEMID_CHILD

요청된 항목에 대한 PIDL입니다. 부모 정보가 pidlParent 또는 psfParent에 포함되지 않은 경우 절대 PIDL이어야 합니다.

[out] ppsi

형식: IShellItem**

이 메서드가 반환되면 는 새 IShellItem에 대한 인터페이스 포인터를 포함합니다.

반환 값

형식: HRESULT

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

설명

SHCreateShellItem 은 셸 네임스페이스 항목을 나타내는 개체를 만듭니다. 호출자는 pidlParent 또는 psfParent에서 부모 정보를 제공해야 합니다. 또는 호출자가 pidl 매개 변수에 절대 IDList를 제공할 수 있습니다.

이 함수에는 세 가지 유효한 호출 패턴이 있습니다.

1. 부모 폴더는 절대 IDList pidlParent로 식별됩니다. pidl 매개 변수는 pidlParent로 식별된 폴더 내의 항목을 식별하는 자식 IDList를 가리킵니다.

   IShellItem *psi;
   SHCreateShellItem(pidlParent, NULL, pidlChild, &psi);
   
   

2. 부모 폴더는 psfParent로 식별됩니다. pidl 매개 변수는 psfParent로 식별된 폴더 내의 항목을 식별하는 자식 IDList를 가리킵니다.

   IShellItem *psi;
   SHCreateShellItem(NULL, psfParent, pidlChild, &psi);
   
   

3. 항목은 pidl 매개 변수에 전달된 절대 IDList로 식별됩니다.

   IShellItem *psi;
   SHCreateShellItem(NULL, NULL, pidlFull, &psi);
   
   

요구 사항

요구 사항	값
지원되는 최소 클라이언트	SP1이 설치된 Windows XP[데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	shlobj_core.h(Shlobj.h 포함)
라이브러리	Shell32.lib
DLL	Shell32.dll
API 세트	ext-ms-win-shell-shell32-l1-2-2(Windows 10 버전 10.0.14393에 도입됨)