Metodo IBidiRequest::GetOutputData (bidispl.h)
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 Osservazioni.
[out] ppszSchema
Puntatore a una stringa con terminazione NULL che riceve la stringa dello schema. Il chiamante deve chiamare la funzione di CoTaskMemFree per liberare questo puntatore.
[out] pdwType
Puntatore a una variabile che riceve il tipo dei dati di output. Questo parametro può essere uno dei valori seguenti.
| Valore | Descrizione |
|---|---|
| BIDI_NULL | Nessun dato. |
| BIDI_INT | Dati interi. |
| 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 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 di interfaccia non è valido. |
| E_POINTER | Almeno uno dei parametri della variabile puntatore non ha fatto riferimento a una posizione di memoria valida. |
| Nessuno dei precedenti | Il HRESULT contiene un codice di errore corrispondente all'ultimo errore. |
Osservazioni
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 pertanto l'applicazione deve liberare entrambi i buffer.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Windows XP |
| server minimo supportato | Windows Server 2003 |
| piattaforma di destinazione | Desktop |
| intestazione | bidispl.h |
| dll | Bidispl.dll |
Vedere anche
interfacce di comunicazione bidirezionali