Función RxCeQueryInformation (rxce.h)

  • Artículo

RxCeQueryInformation consulta información sobre una conexión en un búfer asignado por el autor de la llamada.

Sintaxis

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

Puntero al circuito virtual asociado a esta conexión.

[in] InformationClass

Clase de información deseada para este tipo de consulta. El valor especificado para InformationClass determina el tipo de información que se devuelve. Este parámetro es una enumeración definida en rxcehdlr.h y puede ser uno de los siguientes valores:

RxCeTransportProviderInformation

Consulte el transporte para obtener información del proveedor. Una estructura de RXCE_TRANSPORT_PROVIDER_INFO se copia en el búfer pInformation si se ejecuta correctamente. Tenga en cuenta que RXCE_TRANSPORT_PROVIDER_INFO es una definición de tipo para TDI_PROVIDER_INFO.

RxCeConnectionInformation

Consulte Para obtener información sobre la conexión. Una estructura de RXCE_CONNECTION_INFORMATION se copia en el búfer pInformation cuando se realiza correctamente. Tenga en cuenta que RXCE_CONNECTION_INFORMATION es una definición de tipo para TDI_CONNECTION_INFORMATION.

RxCeConnectionEndpointInformation

Consulte el transporte Para obtener información sobre el punto de conexión. Una estructura de RXCE_CONNECTION_INFO se copia en el búfer pInformation cuando se realiza correctamente. Tenga en cuenta que RXCE_CONNECTION_INFO es una definición de tipo para TDI_CONNECTION_INFO.

RxCeRemoteAddressInformation

Consulte el transporte Para obtener información sobre la dirección remota. Una estructura de TDI_ADDRESS_INFO se copia en el búfer pInformation cuando se realiza correctamente.

[out] pInformation

Búfer proporcionado por el autor de la llamada para devolver información.

[in] Length

Longitud del búfer.

Valor devuelto

RxCeQueryInformation devuelve STATUS_SUCCESS si se ejecuta correctamente o uno de los siguientes códigos de error o advertencia:

Código devuelto Descripción
STATUS_BUFFER_OVERFLOW
 Esta longitud especificada del búfer de salida al que apunta pInformation no era lo suficientemente grande como para recibir la información solicitada por el tipo de consulta InformationClass .
STATUS_INSUFFICIENT_RESOURCES
 Error en la asignación de memoria de grupo no paginada necesaria para esta rutina.
STATUS_INVALID_PARAMETER
 Este valor se puede devolver para cualquiera de las condiciones siguientes:
El parámetro pVC pasado a esta rutina no era válido.
La conexión, la dirección o el transporte definidos para este circuito virtual no eran válidos.
InformationClass para este tipo de consulta no era uno de los valores permitidos.

Comentarios

RxCeQueryInformation devuelve información de un circuito virtual determinado. Los únicos valores de InformationClass que se pueden especificar al llamar a RxCeQueryInformation son los siguientes:

RxCeTransportProviderInformation

RxCeConnectionInformation

RxCeConnectionEndpointInformation

RxCeRemoteAddressInformation

Para algunos valores de InformationClass, RxCeQueryInformation llama a TdiBuildQueryInformation y TDI para recuperar la información solicitada.

Requisitos

Requisito Value
Plataforma de destino Escritorio
Encabezado rxce.h (include Rxce.h, Rxcehdlr.h, Tdi.h)
IRQL <= APC_LEVEL

Consulte también

RxCeQueryAdapterStatus

RxCeQueryTransportInformation