Fonction RxCeQueryInformation (rxce.h)

  • Article

RxCeQueryInformation interroge des informations sur une connexion dans une mémoire tampon allouée par l’appelant.

Syntaxe

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

Paramètres

[in] pVc

Pointeur vers le circuit virtuel associé à cette connexion.

[in] InformationClass

Classe d’informations souhaitée pour ce type de requête. La valeur spécifiée pour InformationClass détermine le type d’informations retournées. Ce paramètre est une énumération définie dans rxcehdlr.h et peut être l’une des valeurs suivantes :

RxCeTransportProviderInformation

Interrogez le transport pour obtenir des informations sur le fournisseur. Une structure RXCE_TRANSPORT_PROVIDER_INFO est copiée dans la mémoire tampon pInformation en cas de réussite. Notez que RXCE_TRANSPORT_PROVIDER_INFO est un typedef pour TDI_PROVIDER_INFO.

RxCeConnectionInformation

Requête Pour obtenir des informations sur la connexion. Une structure RXCE_CONNECTION_INFORMATION est copiée dans la mémoire tampon pInformation en cas de réussite. Notez que RXCE_CONNECTION_INFORMATION est un typedef pour TDI_CONNECTION_INFORMATION.

RxCeConnectionEndpointInformation

Interroger le transport Pour plus d’informations sur le point de terminaison de connexion. Une structure RXCE_CONNECTION_INFO est copiée dans la mémoire tampon pInformation en cas de réussite. Notez que RXCE_CONNECTION_INFO est un typedef pour TDI_CONNECTION_INFO.

RxCeRemoteAddressInformation

Interroger le transport Pour plus d’informations sur l’adresse distante. Une structure TDI_ADDRESS_INFO est copiée dans la mémoire tampon pInformation en cas de réussite.

[out] pInformation

Mémoire tampon fournie par l’appelant pour retourner des informations.

[in] Length

Longueur de la mémoire tampon.

Valeur retournée

RxCeQueryInformation retourne STATUS_SUCCESS sur la réussite ou l’un des codes d’avertissement ou d’erreur suivants :

Code de retour Description
STATUS_BUFFER_OVERFLOW
 Cette longueur spécifiée de la mémoire tampon de sortie pointée par pInformation n’était pas assez grande pour recevoir les informations demandées par le type de requête InformationClass .
STATUS_INSUFFICIENT_RESOURCES
 L’allocation de la mémoire de pool non paginé nécessaire à cette routine a échoué.
STATUS_INVALID_PARAMETER
 Cette valeur peut être retournée pour l’une des conditions suivantes :
Le paramètre pVC passé à cette routine n’était pas valide.
La connexion, l’adresse ou le transport défini pour ce circuit virtuel n’était pas valide.
InformationClass pour ce type de requête n’était pas l’une des valeurs autorisées.

Remarques

RxCeQueryInformation retourne des informations pour un circuit virtuel donné. Les seules valeurs d’InformationClass qui peuvent être spécifiées lors de l’appel de RxCeQueryInformation sont les suivantes :

RxCeTransportProviderInformation

RxCeConnectionInformation

RxCeConnectionEndpointInformation

RxCeRemoteAddressInformation

Pour certaines valeurs d’InformationClass, RxCeQueryInformation appelle TdiBuildQueryInformation et TDI pour récupérer les informations demandées.

Configuration requise

Condition requise Valeur
Plateforme cible Desktop (Expérience utilisateur)
En-tête rxce.h (inclure Rxce.h, Rxcehdlr.h, Tdi.h)
IRQL <= APC_LEVEL

Voir aussi

RxCeQueryAdapterStatus

RxCeQueryTransportInformation