GetProtocolFromTable-Funktion
Die GetProtocolFromTable-Funktion gibt ein Handle an ein Protokoll zurück, das auf einer bestimmten Ü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 zum Suchen des Protokolls in einer Übergabetabelle verwendet wird. Der Wert muss in den Protokolldaten verfügbar sein.
-
lpInstData [out]
-
Falls in der Übergabetabelle verfügbar, instance Daten für das nächste Protokoll. Instanzdaten dürfen nicht länger als eine 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 daten sein, die kleiner oder gleich einer DWORD_PTR Länge sind, oder ein Zeiger auf Daten, z. B. Rohdaten, die vom Parser nicht zugeordnet oder freigegeben werden müssen.
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 |
|