función CIDLData_CreateFromIDArray (shlobj_core.h)
[CIDLData_CreateFromIDArray está disponible para su uso en los sistemas operativos especificados en la sección Requisitos. Puede modificarse o no estar disponible en versiones posteriores.
Crea un objeto de datos con el puntero de tabla virtual predeterminado.
Sintaxis
SHSTDAPI CIDLData_CreateFromIDArray(
[in] PCIDLIST_ABSOLUTE pidlFolder,
[in] UINT cidl,
[in] PCUIDLIST_RELATIVE_ARRAY apidl,
[out] IDataObject **ppdtobj
);
Parámetros
[in] pidlFolder
Tipo: PCIDLIST_ABSOLUTE
IdLIST completo para la raíz de los elementos especificados en apidl.
[in] cidl
Tipo: UINT
Número de entradas de la matriz apidl .
[in] apidl
Tipo: PCUIDLIST_RELATIVE_ARRAY
Matriz de identificadores de elemento relativas a pidlFolder. Normalmente, apidl es una matriz de identificadores secundarios y pidlFolder es un PIDL completo para esos elementos. Sin embargo, pidlFolder puede ser un PIDL nulo (IDLIST de escritorio). En ese caso, apidl puede contener listas de identificadores completos.
[out] ppdtobj
Tipo: IDataObject**
Dirección a un puntero al objeto que implementa IDataObject.
Valor devuelto
Tipo: HRESULT
Si esta función se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.
Comentarios
El objeto de datos creado por esta función ofrece el identificador de formato del Portapapeles de Shell CFSTR_SHELLIDLIST. Este objeto de datos también admite llamadas IDataObject::SetData para recoger otros formatos del Portapapeles.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows 2000 Professional [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows 2000 Server [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | shlobj_core.h (incluya Shlobj.h) |
| Library | Shell32.lib |
| Archivo DLL | Shell32.dll (versión 5.0 o posterior) |
| Conjunto de API | ext-ms-win-shell-shell32-l1-2-1 (introducido en Windows 10, versión 10.0.10240) |