RxCeQueryAdapterStatus-Funktion (rxce.h)

Artikel
02/07/2025

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 Adapterstatus zu halten. Bei der Ausgabe, wenn dieser Aufruf erfolgreich ist, enthält der Puffer den Adapterstatus, der dem angegebenen RDBSS-Transport zugeordnet ist.

Rückgabewert

RxCeQueryAdapterStatus- gibt STATUS_SUCCESS bei Erfolg oder einer der folgenden Fehlercodes für Fehler zurück:

Rückgabecode	Beschreibung
STATUS_ADDRESS_NOT_ASSOCIATED	Eine Adapteradresse ist dem RDBSS-Transport nicht zugeordnet.
STATUS_INSUFFICIENT_RESOURCES	Fehler bei der Zuordnung des nicht ausseitigen Poolspeichers, der von dieser Routine benötigt wird.
STATUS_INVALID_PARAMETER	Der an diese Routine übergebene pTransport Parameter war ungültig.

Bemerkungen

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 ruftTdiBuildQueryInformation- mit einer TDI_QUERY_ADAPTER_STATUS Abfrage auf.