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에 도입됨) |