GetProtocolFromTable-Funktion

Die GetProtocolFromTable-Funktion gibt ein Handle für ein Protokoll zurück, das auf einer angegebenen Übergabetabelle und einem bestimmten Wert basiert.

Syntax

HPROTOCOL WINAPI GetProtocolFromTable(
  _In_  LPHANDOFFTABLE hTable,
  _In_  DWORD          ItemToFind,
  _Out_ PDWORD_PTR     lpInstData
);

Parameter

hTable [ In]

Handle für eine Übergabetabelle.

ItemToFind [ In]

Der Wert, der verwendet wird, um das Protokoll in einer Übergabetabelle zu suchen. Der Wert muss in den Protokolldaten verfügbar sein.

lpInstData [ out]

Falls in der Übergabetabelle verfügbar, werden Instanzdaten für das nächste Protokoll verwendet. Instanzdaten dürfen nicht länger als DWORD _ PTR sein.

Rückgabewert

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

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

Bemerkungen

Beim Implementieren der RecognizeFrame-Exportfunktion wird die GetProtocolFromTable-Funktion verwendet, um ein Handle für das nächste Protokoll abzurufen. Die GetProtocolFromTable-Funktion wird aufgerufen, um ein Handle aus dem nächsten Protokoll abzurufen, wenn das Protokoll identifiziert, welches Protokoll folgt.

Instanzdaten

Instanzdaten können alle Daten sein, die kleiner oder gleich einer DWORD _ PTR-Länge sind, oder ein Zeiger auf Daten, z. B. Rohframedaten, die nicht vom Parser zugeordnet oder freigegeben werden müssen.

Requirements (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

Weitere Informationen

RecognizeFrame