IBidiRequest::GetOutputData-Methode (bidispl.h)

  • Artikel

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