Freigeben über


GetFrameDestAddress-Funktion

Die GetFrameDestAddress-Funktion ruft die Zieladresse eines Frames ab.

Syntax

DWORD WINAPI GetFrameDestAddress(
   HFRAME    hFrame,
   LPADDRESS lpAddress,
   DWORD     AddressType,
   DWORD     Flags
);

Parameter

hFrame

Ein Handle des Frames, auf den ein Zeiger abgerufen werden soll.

lpAddress

Ein Rückgabepuffer, der die Framezieladresse speichert.

Adresstyp

Ein Adresstyp, z. B. ADDRESS_TYPE_ETHERNET oder ADDRESS_TYPE_IP.

Flags

Die Flags, die zum Ändern der zurückgegebenen Zieladressdaten verwendet werden.

Wert Bedeutung
ADDRESSTYPE_FLAGS_NORMALIZE
Bricht die Routing- und Gruppen-BITs ab.
ADDRESSTYPE_FLAGS_BIT_REVERSE
Konvertiert Tokenring-Netzwerkadressen wieder in den Normalzustand.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der lpAddress-Wert gültig, und der Rückgabewert ist BHERR_SUCCESS.

Wenn die Funktion nicht erfolgreich ist, ist der Rückgabewert ein Fehlercode.

Rückgabecode Beschreibung
BHERR_PROTOCOL_NOT_FOUND
Das angegebene Protokoll im AddressType-Parameter ist für den Frame ungültig.
BHERR_INVALID_HFRAME
Der hFrame-Wert ist ungültig.

Bemerkungen

Der ADDRESS_TYPE_FIND_HIGHEST-Adresstyp ist zulässig. Wenn dieser Adresstyp verwendet wird, sucht die Funktion nach der IPX-, XNS-, IP- oder VINES-IP-Adresse, bevor sie die ETHERNET-, TOKENRING- oder FDDI-Adresse zurückgibt. Dieser Ansatz ist nützlich für Protokolle und Umgebungen, in denen zwei NICs unter einer einzelnen Serveradresse multiplext werden können.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)
Windows 2000 Server [nur Desktop-Apps]
Header
Netmon.h
Bibliothek
Nmapi.lib
DLL
Nmapi.dll