Partager via

RxCeQueryInformation, fonction (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

Recherchez 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

Interrogez 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

Interrogez 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 de retour

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

Retourner le code Description
STATUS_BUFFER_OVERFLOW
 Cette longueur spécifiée de la mémoire tampon de sortie pointée par pInformation n’était pas suffisamment grande pour recevoir les informations demandées par le type de requête InformationClass.
STATUS_INSUFFICIENT_RESOURCES
 L’allocation de la mémoire du pool non paginé nécessaire par 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.
La 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 de InformationClass qui peuvent être spécifiées lors de l’appel de RxCeQueryInformation sont les suivantes :

RxCeTransportProviderInformation

RxCeConnectionInformation

RxCeConnectionEndpointInformation

RxCeRemoteAddressInformation

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

Exigences

Exigence Valeur
plateforme cible Bureau
d’en-tête rxce.h (include Rxce.h, Rxcehdlr.h, Tdi.h)
IRQL <= APC_LEVEL

Voir aussi

RxCeQueryAdapterStatus

RxCeQueryTransportInformation