Share via

DPA_LoadStream-Funktion (dpa_dsa.h)

  • Artikel

[DPA_LoadStream ist in Windows Vista verfügbar. Sie kann in nachfolgenden Versionen geändert oder nicht verfügbar sein. ]

Lädt das dynamische Zeigerarray (DPA) aus einem Stream, indem die angegebene Rückruffunktion aufgerufen wird, um die einzelnen Elemente zu lesen.

Syntax

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

Parameter

[out] phdpa

Typ: HDPA*

Ein Handle für eine DPA.

[in] pfn

Typ: PFNDPASTREAM

Die Rückruffunktion. Den Prototyp der Rückruffunktion finden Sie unter PFNDPASTREAM .

[in] pstream

Typ: IStream*

Ein IStream-Objekt .

[in] pvInstData

Typ: void*

Ein Zeiger auf Rückrufdaten. pvInstData wird als Parameter an pfn übergeben.

Rückgabewert

Typ: HRESULT

Gibt einen der folgenden Werte zurück.

Rückgabecode BESCHREIBUNG
S_OK
 Gibt an, dass die Rückruffunktion erfolgreich war und das Element geladen wurde.
S_FALSE
 Gibt an, dass die Rückruffunktion beim Laden des Elements nicht erfolgreich war; Der Prozess sollte jedoch fortgesetzt werden.
E_INVALIDARG
 Gibt an, dass mindestens ein Parameter ungültig ist.
E_FAIL
 Gibt an, dass das Streamobjekt nicht gelesen werden konnte.
E_OUTOFMEMORY
 Die Pufferlänge ist ungültig, oder es war nicht genügend Arbeitsspeicher vorhanden, um den Vorgang abzuschließen.

Hinweise

Diese Funktion muss direkt aus ComCtl32.dll aufgerufen werden. Es ist Ordnungszahl 9.

Der Rückruf ist für das Schreiben der pvInstData-Daten in den Stream verantwortlich.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile dpa_dsa.h
DLL ComCtl32.dll