funzione CIDLData_CreateFromIDArray (shlobj_core.h)

[CIDLData_CreateFromIDArray è disponibile per l'uso nei sistemi operativi specificati nella sezione Requisiti. Può essere modificato o non disponibile nelle versioni successive.

Crea un oggetto dati con il puntatore predefinito della tabella virtuale.

Sintassi

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

Parametri

[in] pidlFolder

Tipo: PCIDLIST_ABSOLUTE

IDLIST completo per la radice degli elementi specificati in apidl.

[in] cidl

Tipo: UINT

Numero di voci nella matrice apidl .

[in] apidl

Tipo: PCUIDLIST_RELATIVE_ARRAY

Matrice di ID elemento relativi a pidlFolder. In genere , apidl è una matrice di ID figlio e pidlFolder è un PIDL completo per tali elementi. Tuttavia, pidlFolder può essere un PIDL null (IDLIST desktop). In questo caso , apidl può contenere elenchi ID completi.

[out] ppdtobj

Tipo: IDataObject**

Indirizzo a un puntatore all'oggetto che implementa IDataObject.

Valore restituito

Tipo: HRESULT

Se questa funzione ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

L'oggetto dati creato da questa funzione offre l'identificatore di formato shell CFSTR_SHELLIDLIST. Questo oggetto dati supporta anche le chiamate IDataObject::SetData per raccogliere altri formati degli Appunti.

Requisiti

Vedi anche

SHCreateDataObject