Compartir a través de

Función RxCeQueryInformation (rxce.h)

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. Se copia una estructura RXCE_TRANSPORT_PROVIDER_INFO en el búfer de pInformation correctamente. Tenga en cuenta que RXCE_TRANSPORT_PROVIDER_INFO es una definición de tipo para TDI_PROVIDER_INFO.

RxCeConnectionInformation

Consulta Para obtener información sobre la conexión. Se copia una estructura RXCE_CONNECTION_INFORMATION en el búfer de pInformation en caso de éxito. 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. Se copia una estructura RXCE_CONNECTION_INFO en el búfer de pInformation si se ejecuta 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. Se copia una estructura de TDI_ADDRESS_INFO en el búfer de pInformation si 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 correctos 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 la memoria del 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.
El informationClass de para este tipo de consulta no era uno de los valores permitidos.

Observaciones

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 Valor
de la plataforma de destino de Escritorio
encabezado de rxce.h (include Rxce.h, Rxcehdlr.h, Tdi.h)
irQL <= APC_LEVEL

Consulte también

rxCeQueryAdapterStatus

RxCeQueryTransportInformation

  • Last updated on