Função RxCeQueryInformation (rxce.h)

  • Artigo

RxCeQueryInformation consulta informações sobre uma conexão em um buffer alocado pelo chamador.

Sintaxe

NTSTATUS RxCeQueryInformation(
  [in]  IN PRXCE_VC                          pVc,
  [in]  IN RXCE_CONNECTION_INFORMATION_CLASS InformationClass,
  [out] OUT PVOID                            pInformation,
  [in]  IN ULONG                             Length
);

Parâmetros

[in] pVc

Um ponteiro para o circuito virtual associado a essa conexão.

[in] InformationClass

A classe de informações desejada para esse tipo de consulta. O valor especificado para InformationClass determina o tipo de informação que é retornado. Esse parâmetro é uma enumeração definida em rxcehdlr.h e pode ser um dos seguintes valores:

RxCeTransportProviderInformation

Consulte o transporte para obter informações do provedor. Uma estrutura RXCE_TRANSPORT_PROVIDER_INFO é copiada para o buffer pInformation com êxito. Observe que RXCE_TRANSPORT_PROVIDER_INFO é um typedef para TDI_PROVIDER_INFO.

RxCeConnectionInformation

Consulta Para obter informações sobre a conexão. Uma estrutura RXCE_CONNECTION_INFORMATION é copiada para o buffer pInformation com êxito. Observe que RXCE_CONNECTION_INFORMATION é um typedef para TDI_CONNECTION_INFORMATION.

RxCeConnectionEndpointInformation

Consulte o transporte Para obter informações sobre o ponto de extremidade de conexão. Uma estrutura RXCE_CONNECTION_INFO é copiada para o buffer pInformation com êxito. Observe que RXCE_CONNECTION_INFO é um typedef para TDI_CONNECTION_INFO.

RxCeRemoteAddressInformation

Consulte o transporte Para obter informações sobre o endereço remoto. Uma estrutura de TDI_ADDRESS_INFO é copiada para o buffer pInformation com êxito.

[out] pInformation

O buffer fornecido pelo chamador para retornar informações.

[in] Length

A duração do buffer.

Retornar valor

RxCeQueryInformation retorna STATUS_SUCCESS com êxito ou um dos seguintes códigos de aviso ou erro:

Código de retorno Descrição
STATUS_BUFFER_OVERFLOW
 Esse comprimento especificado do buffer de saída apontado por pInformation não era grande o suficiente para receber as informações solicitadas pelo tipo de consulta InformationClass .
STATUS_INSUFFICIENT_RESOURCES
 Falha na alocação de memória de pool nãopagado necessária para essa rotina.
STATUS_INVALID_PARAMETER
 Esse valor pode ser retornado para qualquer uma das seguintes condições:
O parâmetro pVC passado para essa rotina era inválido.
A conexão, o endereço ou o transporte definido para esse circuito virtual era inválido.
O InformationClass para esse tipo de consulta não era um dos valores permitidos.

Comentários

RxCeQueryInformation retorna informações para um determinado circuito virtual. Os únicos valores para InformationClass que podem ser especificados ao chamar RxCeQueryInformation são os seguintes:

RxCeTransportProviderInformation

RxCeConnectionInformation

RxCeConnectionEndpointInformation

RxCeRemoteAddressInformation

Para alguns valores de InformationClass, RxCeQueryInformation chama TdiBuildQueryInformation e TDI para recuperar as informações solicitadas.

Requisitos

Requisito Valor
Plataforma de Destino Área de Trabalho
Cabeçalho rxce.h (include Rxce.h, Rxcehdlr.h, Tdi.h)
IRQL <= APC_LEVEL

Confira também

RxCeQueryAdapterStatus

RxCeQueryTransportInformation