GetFrameSourceAddress-Funktion

Die GetFrameSourceAddress-Funktion ruft die Quelladresse eines Frames ab.

Syntax

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

Parameter

hFrame

Ein Handle für den Frame, auf den ein Zeiger angezeigt werden soll.

lpAddress

Ein Rückgabepuffer, der die Quelladresse des Frames speichert.

Adresstyp

Der Typ der gesuchten Adresse, z. B. ADDRESS _ TYPE ETHERNET oder ADDRESS TYPE _ _ _ IP.

Flags

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

Wert Bedeutung
_ADDRESSTYPE-FLAGS _ NORMALISIEREN
Bricht die Routing- und Gruppen-BITs ab.
ADDRESSTYPE _ FLAGS _ BIT _ REVERSE
Konvertiert Tokenringnetzwerkadressen wieder in den normalen Modus.

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-PROTOKOLL _ NICHT _ GEFUNDEN
Das vom AddressType-Parameter angegebene Protokoll ist für den Frame ungültig.
BHERR _ INVALID _ HFRAME
Der hFrame-Parameterwert ist ungültig.

Hinweise

Der Adresstyp ADDRESS TYPE FIND _ _ _ HIGHEST ist zulässig. Wenn dieser Adresstyp verwendet wird, sucht die Funktion nach der IPX-, XNS-, IP- oder VINES-IP-Adresse, bevor die ETHERNET-, TOKENRING- oder FDDI-Adresse zurückgegeben wird. Dieser Ansatz ist nützlich für Protokolle und Umgebungen, in denen zwei NICs unter einer einzelnen Serveradresse multiplexiert 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