funzione DPA_LoadStream (dpa_dsa.h)

  • Articolo

[DPA_LoadStream è disponibile in Windows Vista. Potrebbe essere modificata o non disponibile nelle versioni successive. ]

Carica la matrice DPA (Dynamic Pointer Array) da un flusso chiamando la funzione di callback specificata per leggere ogni elemento.

Sintassi

HRESULT DPA_LoadStream(
  [out] HDPA         *phdpa,
  [in]  PFNDPASTREAM pfn,
  [in]  IStream      *pstream,
  [in]  void         *pvInstData
);

Parametri

[out] phdpa

Tipo: HDPA*

Handle per un DPA.

[in] pfn

Tipo: PFNDPASTREAM

Funzione di callback. Per il prototipo della funzione di callback, vedere PFNDPASTREAM .

[in] pstream

Tipo: IStream*

Oggetto IStream .

[in] pvInstData

Tipo: void*

Puntatore ai dati di callback. pvInstData viene passato come parametro a pfn.

Valore restituito

Tipo: HRESULT

Restituisce uno dei valori seguenti.

Codice restituito Descrizione
S_OK
 Indica che la funzione di callback ha avuto esito positivo e che l'elemento è stato caricato.
S_FALSE
 Indica che la funzione di callback non è riuscita a caricare l'elemento; tuttavia, il processo deve continuare.
E_INVALIDARG
 Indica che uno o più parametri non sono validi.
E_FAIL
 Indica che non è stato possibile leggere l'oggetto flusso.
E_OUTOFMEMORY
 La lunghezza del buffer non è valida o la memoria non è sufficiente per completare l'operazione.

Commenti

Questa funzione deve essere chiamata direttamente da ComCtl32.dll. È ordinale 9.

Il callback è responsabile della scrittura dei dati pvInstData nel flusso.

Requisiti

   
Client minimo supportato Windows Vista [solo app desktop]
Server minimo supportato Windows Server 2003 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione dpa_dsa.h
DLL ComCtl32.dll