AttachProperties-Rückruffunktion
Die Exportfunktion AttachProperties ordnet die Eigenschaften einer Position innerhalb eines Teils erkannter Daten zu. AttachProperties muss für jeden Parser implementiert werden, den die Parser-DLL unterstützt.
Syntax
DWORD AttachProperties(
_In_ HFRAME hFrame,
_In_ LPBYTE lpFrame,
_In_ LPBYTE lpProtocol,
_In_ DWORD MacType,
_In_ DWORD BytesLeft,
_In_ HPROTOCOL hPreviousProtocol,
_In_ DWORD nPreviousProtocolOffset,
_In_ DWORD lpInstData
);
Parameter
-
hFrame [in]
-
Handle des Frames, der analysiert wird.
-
lpFrame [in]
-
Zeiger auf das erste Byte in einem Frame.
-
lpProtocol [in]
-
Zeiger auf den Anfang der erkannten Daten.
-
MacType [in]
-
MAC-Wert des ersten Protokolls in einem Frame. MacType kann einer der folgenden Sein:
Wert Bedeutung - MAC_TYPE_ETHERNET
802.3 - MAC_TYPE_TOKENRING
802.5 - MAC_TYPE_FDDI
ANSI X3T9.5 -
BytesLeft [in]
-
Die verbleibende Anzahl von Bytes in einem Frame, die am Anfang der erkannten Daten beginnt.
-
hPreviousProtocol [in]
-
Handle des vorherigen Protokolls.
-
nPreviousProtocolOffset [in]
-
Offset des vorherigen Protokolls, beginnend am Anfang des Frames.
-
lpInstData [in]
-
Zeiger auf die instance Daten, die das vorherige Protokoll bereitstellt. Instanzdaten dürfen nicht länger als eine DWORD_PTR sein.
Rückgabewert
Wenn die Funktion erfolgreich ist, ist der Rückgabewert ein Zeiger auf das erste Byte nach den erkannten Daten in einem Frame oder NULL , wenn die erkannten Daten das letzte Datenstück in einem Frame sind.
Wenn die Funktion nicht erfolgreich ist, ist der Rückgabewert ein Zeiger auf die erkannten Daten. Der parameter lpProtocol übergibt den Zeiger an die Parser-DLL.
Bemerkungen
Netzwerkmonitor ruft die AttachProperties-Funktion für jeden Parser auf, der ein Datenelement in einem Frame erkennt. Beachten Sie, dass der Parser bestimmt, welche Eigenschaften in den erkannten Daten vorhanden sind und wo sich die einzelnen Eigenschaften befinden.
Rufen Sie während der Implementierung von AttachPropertiesAttachPropertyInstance auf, um die Daten so zu verwenden, wie sie in der Erfassung vorhanden sind. Sie können auch die AttachPropertyInstanceEx-Funktion aufrufen, um die Eigenschaftendaten zu ändern. Es wird jedoch empfohlen, die Daten so zu verwenden, wie sie in der Erfassung vorhanden sind.
Die Funktionen AttachPropertyInstanceEx und AttachPropertyInstance werden nur für die Eigenschaften aufgerufen, die in den erkannten Daten vorhanden sind. Beachten Sie, dass der Netzwerkmonitor über eine Eigenschaftendatenbank für den Parser verfügt, die eine Beschreibung aller Eigenschaften enthält, die der Parser unterstützt.
Instanzdaten
Instanzdaten sind Informationen, die von einem Parser an einen anderen übergeben werden. Instanzdaten können 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. Im lpInstData-Parameter der Funktionen AttachProperties und RecognizeFrame stellt der Netzwerkmonitor einen Zeiger auf die instance Daten des vorherigen Protokolls bereit. Sie können die instance Daten für Ihren Parser während der Implementierung von RecognizeFrame festlegen.
| Für Informationen zu | Siehe |
|---|---|
| Was Parser sind und wie sie mit Dem Netzwerkmonitor funktionieren. | Parser |
| Welche Einstiegspunkte sind in der Parser-DLL enthalten. | Parser-DLL-Architektur |
| Erkennen von Daten. | Implementieren von RecognizeFrame |
| Erstellen einer Eigenschaftendatenbank. | Implementieren von Register |
| Das Implementieren von AttachProperties enthält ein Beispiel. | Implementieren von AttachProperties |
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Windows 2000 Server [nur Desktop-Apps] |
| Header |
|