Implementieren von FormatProperties
Netzwerkmonitor ruft die FormatProperties-Funktion auf, um die Daten zu formatieren, die im Detailbereich der Netzwerkmonitor werden. In der Regel wird FormatProperties aufgerufen, um die Zusammenfassungszeile für ein Protokoll zu formatieren und dann alle Eigenschafteninstanzen des Protokolls innerhalb eines Frames zu formatieren. Allerdings Netzwerkmonitor nicht, wie oft FormatProperties für einen bestimmten Parser aufgerufen wird.
Beim Aufrufen von FormatPropertiesstellt Netzwerkmonitor eine PROPERTYINST-Struktur für jede angezeigte Eigenschaft zur Verfügung. Die PROPERTYINST-Struktur stellt Informationen zu den anzuzeigenden Daten zur Verfügung, einschließlich eines Zeigers auf die PROPERTYINFO-Struktur, der die Funktion angibt, die zum Formatieren der angezeigten Dateneigenschaft verwendet werden soll.
Hinweis
Eine PROPERTYINFO-Struktur wird angegeben, wenn der Eigenschaftendatenbank des Parsers eine Eigenschaft hinzugefügt wird.
Netzwerkmonitor identifiziert die Formatfunktion, die für jede Eigenschafteninstanz aufruft werden soll. Der InstanceData-Member der PROPERTYINFO-Struktur kann Folgendes angeben:
Die FormatPropertyInstance-Funktion zur Verwendung des generischen Formatierungsformaters, der von Netzwerkmonitor wird.
– oder –
Der Name einer benutzerdefinierten Formatfunktion, die der Parser zur Verfügung stellt.
Die FormatPropertyInstance- und die benutzerdefinierten Formatfunktionen geben die formatierten Daten zurück, die im Detailbereich der benutzeroberfläche Netzwerkmonitor werden.
Die folgende Abbildung zeigt, Netzwerkmonitor die Funktion identifiziert, die für jede Eigenschafteninstanz aufruft.

Im folgenden Verfahren werden die erforderlichen Schritte zum Implementieren von FormatProperties beschrieben.
So implementieren Sie FormatProperties
- Rufen Sie mithilfe einer Schleifenstruktur die Formatfunktion für jede PROPERTYINST-Struktur auf, die im lpPropInst-Parameter der FormatProperties-Funktion an den Parser übergeben wird.
Im Folgenden finden Sie eine grundlegende Implementierung von FormatProperties.
#include <windows.h>
DWORD BHAPI MyProtocolFormatProperties( HFRAME hFrame,
LPBYTE pMacFrame,
LPBYTE pBLRPLATEFrame,
DWORD nPropertyInsts
LPPROPERTYINST p)
{
while( nPropertyInsts-- > 0)
{
( (FORMAT) p->lpPropertyInfo->InstanceData) ) (p);
p++;
}
return BHERR_SUCCESS;
}