RxCeQueryAdapterStatus, fonction (rxce.h)

Article
02/07/2025

RxCeQueryAdapterStatus retourne la structure ADAPTER_STATUS pour un transport donné dans une mémoire tampon allouée par l’appelant.

Syntaxe

NTSTATUS RxCeQueryAdapterStatus(
  PRXCE_TRANSPORT pTransport,
  _ADAPTER_STATUS *pAdapterStatus
);

Paramètres

pTransport

Pointeur vers le transport RDBSS associé à un adaptateur.

pAdapterStatus

Lors de l’entrée, ce paramètre contient un pointeur vers la mémoire tampon allouée à l’appelant pour contenir l’état de l’adaptateur. Lorsque cet appel réussit, la mémoire tampon contient l’état de l’adaptateur associé au transport RDBSS spécifié.

Valeur de retour

RxCeQueryAdapterStatus retourne STATUS_SUCCESS sur la réussite ou l’un des codes d’erreur suivants en cas d’échec :

Retourner le code	Description
STATUS_ADDRESS_NOT_ASSOCIATED	Une adresse d’adaptateur n’est pas associée au transport RDBSS.
STATUS_INSUFFICIENT_RESOURCES	L’allocation de la mémoire du pool non paginé nécessaire par cette routine a échoué.
STATUS_INVALID_PARAMETER	Le paramètre pTransport passé à cette routine n’était pas valide.

Remarques

RxCeQueryAdapterStatus retourne une structure ADAPTER_STATUS pour un transport donné. Cette routine est généralement utilisée pour obtenir le nom NetBIOS de l’adaptateur.

RxCeQueryAdapterStatus appelle TdiBuildQueryInformation avec une requête TDI_QUERY_ADAPTER_STATUS.