IBidiRequest::GetOutputData-Methode (bidispl.h)

Artikel
02/06/2025

Die GetOutputData Methode ruft die angegebenen Ausgabedaten ab, die vom Drucker zurückgegeben werden.

Syntax

HRESULT GetOutputData(
  [in]  const DWORD dwIndex,
  [out] LPWSTR      *ppszSchema,
  [out] DWORD       *pdwType,
  [out] BYTE        **ppData,
  [out] ULONG       *uSize
);

Parameter

[in] dwIndex

Ein nullbasierter Index der angeforderten Ausgabedaten. Weitere Informationen finden Sie in den Hinweisen.

[out] ppszSchema

Ein Zeiger auf eine MIT NULL beendete Zeichenfolge, die die Schemazeichenfolge empfängt. Der Aufrufer muss die CoTaskMemFree--Funktion aufrufen, um diesen Zeiger freizurufen.

[out] pdwType

Ein Zeiger auf eine Variable, die den Typ der Ausgabedaten empfängt. Dieser Parameter kann einer der folgenden Werte sein:

Wert	Beschreibung
BIDI_NULL	Keine Daten.
BIDI_INT	Ganzzahlige Daten.
BIDI_FLOAT	Gleitkommazahl.
BIDI_BOOL	WAHR- oder FALSCH-
BIDI_STRING	Unicode-Zeichenzeichenfolge.
BIDI_TEXT	Nicht lokalisierbare Unicode-Zeichenfolge.
BIDI_ENUM	Enumerationsdaten in Form einer Unicode-Zeichenfolge.
BIDI_BLOB	Binäre Daten.

[out] ppData

Ein Zeiger auf die Variable, die einen Zeiger auf das Bytearray empfängt, das die Ausgabedaten enthält. Der Puffer wird von der COM-Schnittstelle zugewiesen, um die Ausgabedaten zu speichern. Der Aufrufer ist für das Aufrufen CoTaskMemFree- verantwortlich, um den Puffer freizulösen.

[out] uSize

Ein Zeiger auf eine Variable, die die Größe des byte-Arrays empfängt, das von **ppData angegeben wird.

Rückgabewert

Die Methode gibt einen der folgenden Werte zurück. Weitere Informationen zu COM-Fehlercodes finden Sie unter COM-Fehlercodes.

Rückgabecode	Beschreibung
S_OK	Der Vorgang wurde erfolgreich durchgeführt.
E_HANDLE	Das Schnittstellenhandle war ungültig.
E_POINTER	Mindestens auf einen der Zeigervariablenparameter wurde kein gültiger Speicherspeicherort verwiesen.
Keine der oben genannten	Die HRESULT- enthält einen Fehlercode, der dem letzten Fehler entspricht.

Bemerkungen

Eine einzelne bidi-Anforderung kann mehrere Ergebnisse aufweisen. Die Anwendung ruft GetEnumCount auf, um die Anzahl der Ergebnisse aus der bidi-Anforderung abzurufen.

Wenn eine Anwendung GetOutputData- mit demselben Index zweimal aufruft, weist die Schnittstelle zwei verschiedene Puffer zu und daher muss die Anwendung beide Puffer freigeben.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows XP
mindestens unterstützte Server-	Windows Server 2003
Zielplattform-	Desktop
Header-	bidispl.h
DLL-	Bidispl.dll

Siehe auch

bidirektionale Kommunikationsschnittstellen

bidirektionales Kommunikationsschema

GetEnumCount-

IBidiRequest

Freigeben über