IBidiRequest::GetOutputData-Methode (bidispl.h)

Artikel
02/22/2024

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 NULL-beendete Zeichenfolge, die die Schemazeichenfolge empfängt. Der Aufrufer muss die CoTaskMemFree-Funktion aufrufen, um diesen Zeiger frei zu machen.

[out] pdwType

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

Wert	BESCHREIBUNG
BIDI_NULL	Keine Daten.
BIDI_INT	Ganzzahlige Daten.
BIDI_FLOAT	Gleitkommazahl.
BIDI_BOOL	TRUE oder FALSE
BIDI_STRING	Unicode-Zeichenfolge.
BIDI_TEXT	Nicht lokalisierbare Unicode-Zeichenfolge.
BIDI_ENUM	Enumerationsdaten in Form einer Unicode-Zeichenfolge.
BIDI_BLOB	Binärdaten.

[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 den Aufruf von CoTaskMemFree verantwortlich, um den Puffer frei zu machen.

[out] uSize

Ein Zeiger auf eine Variable, die die Größe des Bytearrays empfängt, die durch **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 einer der Zeigervariablenparameter verweist nicht auf einen gültigen Speicherspeicherort.
Keine der oben genannten Antworten trifft zu.	Das HRESULT enthält einen Fehlercode, der dem letzten Fehler entspricht.

Hinweise

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 zweimal mit demselben Index aufruft, weist die Schnittstelle zwei verschiedene Puffer zu, sodass die Anwendung beide Puffer freigeben muss.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP
Unterstützte Mindestversion (Server)	Windows Server 2003
Zielplattform	Desktop
Kopfzeile	bidispl.h
DLL	Bidispl.dll

Weitere Informationen

Bidirektionale Kommunikationsschnittstellen

Bidirektionales Kommunikationsschema

GetEnumCount

IBidiRequest

Freigeben über