Método IBidiRequest::GetOutputData (bidispl.h)
O método GetOutputData obtém os dados de saída especificados provenientes da impressora.
Sintaxe
HRESULT GetOutputData(
[in] const DWORD dwIndex,
[out] LPWSTR *ppszSchema,
[out] DWORD *pdwType,
[out] BYTE **ppData,
[out] ULONG *uSize
);
Parâmetros
[in] dwIndex
Um índice baseado em zero dos dados de saída solicitados. Para obter mais informações, consulte Comentários.
[out] ppszSchema
Um ponteiro para uma cadeia de caracteres terminada em NULL que recebe a cadeia de caracteres de esquema. O chamador deve chamar a função CoTaskMemFree para liberar esse ponteiro.
[out] pdwType
Um ponteiro para uma variável que recebe o tipo de dados de saída. Esse parâmetro pode usar um dos valores a seguir.
| Valor | Descrição |
|---|---|
| BIDI_NULL | Sem dados. |
| BIDI_INT | Dados Integer. |
| BIDI_FLOAT | Número de ponto flutuante. |
| BIDI_BOOL | TRUE ou FALSE |
| BIDI_STRING | Cadeia de caracteres Unicode. |
| BIDI_TEXT | Cadeia de caracteres Unicode não localizável. |
| BIDI_ENUM | Dados de enumeração na forma de uma cadeia de caracteres Unicode. |
| BIDI_BLOB | Dados binários. |
[out] ppData
Um ponteiro para a variável que recebe um ponteiro para a matriz de bytes que contém os dados de saída. O buffer é alocado pela interface COM para armazenar os dados de saída. O chamador é responsável por chamar CoTaskMemFree para liberar o buffer.
[out] uSize
Um ponteiro para uma variável que recebe o tamanho da matriz de bytes especificada por **ppData.
Retornar valor
O método retorna um dos valores a seguir. Para obter mais informações sobre códigos de erro COM, consulte Códigos de erro COM.
| Código de retorno | Descrição |
|---|---|
| S_OK | A operação foi realizada com êxito. |
| E_HANDLE | O identificador da interface era inválido. |
| E_POINTER | Pelo menos um dos parâmetros de variável de ponteiro não fez referência a um local de memória válido. |
| Nenhuma das opções acima | O HRESULT contém um código de erro correspondente ao último erro. |
Comentários
Uma única solicitação bidi pode ter vários resultados. O aplicativo chama GetEnumCount para obter o número de resultados da solicitação bidi.
Se um aplicativo chamar GetOutputData com o mesmo índice duas vezes, a interface alocará dois buffers diferentes e, portanto, o aplicativo deverá liberar ambos os buffers.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows XP |
| Servidor mínimo com suporte | Windows Server 2003 |
| Plataforma de Destino | Área de Trabalho |
| Cabeçalho | bidispl.h |
| DLL | Bidispl.dll |
Confira também
Interfaces de comunicação bidirecional