RxCeQueryAdapterStatus-Funktion (rxce.h)

Artikel
02/26/2024

RxCeQueryAdapterStatus gibt die ADAPTER_STATUS-Struktur für einen bestimmten Transport in einem vom Aufrufer zugewiesenen Puffer zurück.

Syntax

NTSTATUS RxCeQueryAdapterStatus(
  PRXCE_TRANSPORT pTransport,
  _ADAPTER_STATUS *pAdapterStatus
);

Parameter

pTransport

Ein Zeiger auf den RDBSS-Transport, der einem Adapter zugeordnet ist.

pAdapterStatus

Bei der Eingabe enthält dieser Parameter einen Zeiger auf den vom Aufrufer zugewiesenen Puffer, um den Adapter status zu halten. Bei der Ausgabe, wenn dieser Aufruf erfolgreich ist, enthält der Puffer den Adapter status, der dem angegebenen RDBSS-Transport zugeordnet ist.

Rückgabewert

RxCeQueryAdapterStatus gibt bei Erfolg STATUS_SUCCESS oder einen der folgenden Fehlercodes bei Fehler zurück:

Rückgabecode	Beschreibung
STATUS_ADDRESS_NOT_ASSOCIATED	Eine Adapteradresse ist dem RDBSS-Transport nicht zugeordnet.
STATUS_INSUFFICIENT_RESOURCES	Bei der Zuordnung des nicht auslagerten Poolspeichers, der für diese Routine benötigt wird, ist ein Fehler aufgetreten.
STATUS_INVALID_PARAMETER	Der an diese Routine übergebene pTransport-Parameter war ungültig.

Hinweise

RxCeQueryAdapterStatus gibt eine ADAPTER_STATUS-Struktur für einen bestimmten Transport zurück. Diese Routine wird am häufigsten verwendet, um den NetBIOS-Namen des Adapters abzurufen.

RxCeQueryAdapterStatus ruft TdiBuildQueryInformation mit einer TDI_QUERY_ADAPTER_STATUS Abfrage auf.