Metodo IBidiRequest::GetOutputData (bidispl.h)

  • Articolo

Il metodo GetOutputData ottiene i dati di output specificati restituiti dalla stampante.

Sintassi

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

Parametri

[in] dwIndex

Indice in base zero dei dati di output richiesti. Per altre informazioni, vedere la sezione Osservazioni.

[out] ppszSchema

Puntatore a una stringa con terminazione NULL che riceve la stringa dello schema. Il chiamante deve chiamare la funzione CoTaskMemFree per liberare questo puntatore.

[out] pdwType

Puntatore a una variabile che riceve il tipo di dati di output. Questo parametro può avere uno dei valori seguenti.

Valore Descrizione
BIDI_NULL Nessun dato.
BIDI_INT Dati integer.
BIDI_FLOAT Numero a virgola mobile.
BIDI_BOOL TRUE o FALSE
BIDI_STRING Stringa di caratteri Unicode.
BIDI_TEXT Stringa Unicode non localizzabile.
BIDI_ENUM Enumerazione dei dati sotto forma di stringa Unicode.
BIDI_BLOB Dati binari.

[out] ppData

Puntatore alla variabile che riceve un puntatore alla matrice di byte contenente i dati di output. Il buffer viene allocato dall'interfaccia COM per archiviare i dati di output. Il chiamante è responsabile della chiamata a CoTaskMemFree per liberare il buffer.

[out] uSize

Puntatore a una variabile che riceve le dimensioni della matrice di byte specificata da **ppData.

Valore restituito

Il metodo restituisce uno dei valori seguenti. Per altre informazioni sui codici di errore COM, vedere Codici di errore COM.

Codice restituito Descrizione
S_OK L'operazione è stata eseguita correttamente.
E_HANDLE L'handle dell'interfaccia non è valido.
E_POINTER Almeno uno dei parametri della variabile puntatore non ha fatto riferimento a una posizione di memoria valida.
Nessuna delle opzioni precedenti HRESULT contiene un codice di errore corrispondente all'ultimo errore.

Commenti

Una singola richiesta bidi può avere più risultati. L'applicazione chiama GetEnumCount per ottenere il numero di risultati dalla richiesta bidi.

Se un'applicazione chiama GetOutputData con lo stesso indice due volte, l'interfaccia alloca due buffer diversi e quindi l'applicazione deve liberare entrambi i buffer.

Requisiti

Requisito Valore
Client minimo supportato Windows XP
Server minimo supportato Windows Server 2003
Piattaforma di destinazione Desktop
Intestazione bidispl.h
DLL Bidispl.dll

Vedi anche

Interfacce di comunicazione bidirezionali

Schema di comunicazione bidirezionale

GetEnumCount

IBidiRequest