Método IBidiRequest::GetOutputData (bidispl.h)

Artigo
02/06/2025

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 dos dados de saída. Esse parâmetro pode ser um dos valores a seguir.

Valor	Descrição
BIDI_NULL	Nenhum dado.
BIDI_INT	Dados inteiros.
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.

Valor de retorno

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 de 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 acima	O HRESULT contém um código de erro correspondente ao último erro.

Observações

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
de cliente com suporte mínimo	Windows XP
servidor com suporte mínimo	Windows Server 2003
da Plataforma de Destino	Área de trabalho
cabeçalho	bidispl.h
de DLL	Bidispl.dll

Consulte também

interfaces de comunicação bidirecional

esquema de comunicação bidirecional

GetEnumCount

IBidiRequest

Partilhar via