Rückruffunktion "FormatProperties"
Die Exportfunktion FormatProperties formatiert die Daten, die im Detailbereich der Netzwerkmonitor Ui angezeigt werden. Wenn Sie Daten im Detailbereich anzeigen möchten, müssen Sie die Exportfunktion FormatProperties in allen Parser-DLLs implementieren.
Syntax
DWORD FormatProperties(
_In_ HFRAME hFrame,
_In_ LPBYTE lpFrame,
_In_ LPBYTE lpProtocol,
_In_ DWORD nPropertyInsts,
_In_ LPPROPERTYINST lpPropInst
);
Parameter
-
hFrame [ In]
-
Handle für den Frame, der analysiert wird.
-
lpFrame [ In]
-
Zeiger auf das erste Byte eines Frames.
-
lpProtocol [ In]
-
Zeiger auf den Anfang der Protokolldaten in einem Frame.
-
nPropertyInsts [ In]
-
Anzahl der PROPERTYINST-Strukturen, die von lpPropInst bereitgestellt werden.
-
lpPropInst [ In]
-
Zeiger auf ein Array von PROPERTYINST-Strukturen.
Rückgabewert
Wenn die Funktion erfolgreich ist, ist der Rückgabewert TRUE.
Wenn die Funktion nicht erfolgreich ist, lautet der Rückgabewert FALSE.
Bemerkungen
Netzwerkmonitor ruft die FormatProperties-Funktion auf, um Daten im Detailbereich der Netzwerkmonitor-Benutzeroberfläche anzuzeigen. In der Regel wird FormatProperties aufgerufen, um die Zusammenfassungszeile für ein Protokoll und dann alle Eigenschafteninstanzen des Protokolls innerhalb eines Frames zu formatieren. Netzwerkmonitor garantiert jedoch nicht, wie oft FormatProperties für einen bestimmten Parser aufruft.
Während der Implementierung der FormatProperties-Funktion ruft der Parser indirekt die FormatPropertyInstance-Funktion auf, um das generische Formatierungsformatierer zu verwenden, das Netzwerkmonitor bereitstellt, oder er kann eine benutzerdefinierte Formatierungsprozedur aufrufen, die vom Parser definiert wird. Einer der Formatierer muss für jede PROPERTYINST-Struktur aufgerufen werden, die im lpPropInst-Parameter an die Parser-DLL übergeben wird.
| Informationen zu | Siehe |
|---|---|
| Was Parser sind und wie sie mit Netzwerkmonitor arbeiten. | Parser |
| Welche Einstiegspunkte in der Parser-DLL enthalten sind. | Parser-DLL-Architektur |
| Die Implementierung von FormatProperties umfasst ein Beispiel. | Implementieren von FormatProperties |
| Formatieren verschiedener Datentypen durch das generische Formatierungsformatierer | Generische Formatierungsausgabe |
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 |
|