CIDLData_CreateFromIDArray 함수(shlobj_core.h)

[CIDLData_CreateFromIDArray 요구 사항 섹션에 지정된 운영 체제에서 사용할 수 있습니다. 이후 버전에서는 변경되거나 제공되지 않을 수 있습니다.]

기본 vtable 포인터를 사용하여 데이터 개체를 만듭니다.

구문

SHSTDAPI CIDLData_CreateFromIDArray(
  [in]  PCIDLIST_ABSOLUTE        pidlFolder,
  [in]  UINT                     cidl,
  [in]  PCUIDLIST_RELATIVE_ARRAY apidl,
  [out] IDataObject              **ppdtobj
);

매개 변수

[in] pidlFolder

형식: PCIDLIST_ABSOLUTE

apidl에 지정된 항목의 루트에 대한 정규화된 IDLIST입니다.

[in] cidl

형식: UINT

apidl 배열의 항목 수입니다.

[in] apidl

형식: PCUIDLIST_RELATIVE_ARRAY

pidlFolder를 기준으로 하는 항목 ID의 배열입니다. 일반적으로 apidl 은 자식 ID의 배열이며 pidlFolder 는 해당 항목에 대한 전체 PIDL입니다. 그러나 pidlFolder 는 null PIDL(데스크톱 IDLIST)일 수 있습니다. 이 경우 apidl 에는 정규화된 ID 목록이 포함될 수 있습니다.

[out] ppdtobj

형식: IDataObject**

IDataObject를 구현하는 개체에 대한 포인터에 대한 주소입니다.

반환 값

형식: HRESULT

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

설명

이 함수에서 만든 데이터 개체는 Shell 클립보드 형식 식별자 CFSTR_SHELLIDLIST 제공합니다. 이 데이터 개체는 다른 클립보드 형식을 선택하기 위한 IDataObject::SetData 호출도 지원합니다.

요구 사항

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

추가 정보

SHCreateDataObject