DPA_SaveStream-Funktion (dpa_dsa.h)

Artikel
03/01/2024

[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

Freigeben über