FormatProperties-Rückruffunktion
Die Exportfunktion FormatProperties formatiert die Daten, die im Detailbereich der Benutzeroberfläche des Netzwerkmonitors angezeigt werden. Wenn Sie Daten im Detailbereich anzeigen möchten, müssen Sie die Exportfunktion FormatEigenschaften 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, ist der Rückgabewert FALSE.
Bemerkungen
Network Monitor ruft die FormatProperties-Funktion auf, um Daten im Detailbereich der Benutzeroberfläche des Netzwerkmonitors anzuzeigen. In der Regel wird FormatProperties aufgerufen, um die Zusammenfassungszeile für ein Protokoll zu formatieren und dann alle Eigenschaftsinstanzen des Protokolls in einem Frame zu formatieren. Der Netzwerkmonitor garantiert jedoch nicht, wie oft FormatProperties für einen bestimmten Parser aufgerufen wird.
Während der Implementierung der FormatProperties-Funktion ruft der Parser indirekt die FormatPropertyInstance-Funktion auf, um den generischen Formatierer zu verwenden, den Network Monitor 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 an die Parser-DLL im lpPropInst-Parameter übergeben wird.
| Informationen zu | Siehe |
|---|---|
| Was Parser sind und wie sie mit Dem Netzwerkmonitor arbeiten. | Parser |
| Welche Einstiegspunkte sind in der Parser-DLL enthalten. | Architektur der Parser-DLL |
| Die Implementierung von FormatProperties enthält ein Beispiel. | Implementieren von FormatProperties |
| Wie der generische Formatierer verschiedene Datentypen formatiert. | Generische Formatiererausgabe |
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Windows 2000 Server [nur Desktop-Apps] |
| Header |
|