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

  • Artigo

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

Esquema de comunicação bidirecional

GetEnumCount

IBidiRequest