Fonction RxCeQueryAdapterStatus (rxce.h)

Article
02/26/2024

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

Syntaxe

NTSTATUS RxCeQueryAdapterStatus(
  PRXCE_TRANSPORT pTransport,
  _ADAPTER_STATUS *pAdapterStatus
);

Paramètres

pTransport

Pointeur vers le transport RDBSS associé à une carte.

pAdapterStatus

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

Valeur retournée

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

Code de retour	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 de pool non paginé nécessaire à 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 la plus couramment utilisée pour obtenir le nom NetBIOS de l’adaptateur.

RxCeQueryAdapterStatus appelle TdiBuildQueryInformation avec une requête TDI_QUERY_ADAPTER_STATUS.