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
Netmon.h

Weitere Informationen

FormatPropertyInstance

PROPERTYINFO

PROPERTYINST