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 |
|
| Bibliothek |
|
| DLL |
|