Função CIDLData_CreateFromIDArray (shlobj_core.h)
[CIDLData_CreateFromIDArray está disponível para uso nos sistemas operacionais especificados na seção Requisitos. Ele pode estar alterado ou indisponível em versões subsequentes.]
Cria um objeto de dados com o ponteiro de vtable padrão.
Sintaxe
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
Uma IDLIST totalmente qualificada para a raiz dos itens especificados em apidl.
[in] cidl
Tipo: UINT
O número de entradas na matriz apidl .
[in] apidl
Tipo: PCUIDLIST_RELATIVE_ARRAY
A matriz de IDs de item em relação a pidlFolder. Normalmente, apidl é uma matriz de IDs filho e pidlFolder é um PIDL completo para esses itens. No entanto, pidlFolder pode ser um PIDL nulo (IDLISTs da área de trabalho). Nesse caso, apidl pode conter listas de ID totalmente qualificadas.
[out] ppdtobj
Tipo: IDataObject**
O endereço para um ponteiro para o objeto que implementa IDataObject.
Retornar valor
Tipo: HRESULT
Se essa função for bem-sucedida, ela retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.
Comentários
O objeto de dados criado por essa função oferece o identificador de formato da área de transferência do Shell CFSTR_SHELLIDLIST. Esse objeto de dados também dá suporte a chamadas IDataObject::SetData para escolher outros formatos de área de transferência.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 2000 Professional [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows 2000 Server [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | shlobj_core.h (inclua Shlobj.h) |
| Biblioteca | Shell32.lib |
| DLL | Shell32.dll (versão 5.0 ou posterior) |
| Conjunto de APIs | ext-ms-win-shell32-l1-2-1 (introduzido no Windows 10, versão 10.0.10240) |