Função RxCeQueryInformation (rxce.h)

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 de RXCE_TRANSPORT_PROVIDER_INFO é copiada para o buffer de pInformation com êxito. Observe que RXCE_TRANSPORT_PROVIDER_INFO é um typedef para TDI_PROVIDER_INFO.

RxCeConnectionInformation

Consulte para obter informações sobre a conexão. Uma estrutura de RXCE_CONNECTION_INFORMATION é copiada para o buffer de de 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 de RXCE_CONNECTION_INFO é copiada para o buffer de de 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 de de pInformation com êxito.

[out] pInformation

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

[in] Length

O comprimento do buffer.

Valor de retorno

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	Este de comprimento de 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ãopagada 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.

Observações

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 chamadas TdiBuildQueryInformation e TDI para recuperar as informações solicitadas.

Requisitos

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

Consulte também

RxCeQueryAdapterStatus

RxCeQueryTransportInformation