DPA_SaveStream-Funktion (dpa_dsa.h)

  • Artikel

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

Speichert das dynamische Zeigerarray (DPA) in einem Stream, indem ein Header ausgeschrieben und dann die angegebene Rückruffunktion aufgerufen wird, um jedes Element zu schreiben.

Syntax

HRESULT DPA_SaveStream(
  [in] HDPA         hdpa,
  [in] PFNDPASTREAM pfn,
  [in] IStream      *pstream,
  [in] void         *pvInstData
);

Parameter

[in] hdpa

Typ: HDPA

Empfängt ein Handle für eine DPA.

[in] pfn

Typ: PFNDPASTREAM

Die Rückruffunktion. Den Rückruffunktionsprototyp 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 beim Speichern des Elements nicht erfolgreich war. Der Prozess sollte jedoch fortgesetzt werden.
S_FALSE
 Gibt an, dass der Prozess unterbrechungsfrei war, obwohl der Rückruf nicht erfolgreich war.
E_INVALIDARG
 Gibt an, dass mindestens einer der Parameter ungültig ist.

Hinweise

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

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

Anforderungen

Anforderung Wert
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