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)

Confira também

SHCreateDataObject