AttachPropertyInstance-Funktion

Die AttachPropertyInstance-Funktion ordnet eine vorhandene Eigenschaft einer bestimmten Position in den erkannten Daten zu.

Syntax

BOOL WINAPI AttachPropertyInstance(
  _In_ HFRAME    hFrame,
  _In_ HPROPERTY hProperty,
  _In_ DWORD     Length,
  _In_ ULPVOID   lpData,
  _In_ DWORD     HelpID,
  _In_ DWORD     IndentLevel,
  _In_ DWORD     IFlags
);

Parameter

hFrame [ In]

Handle für den Frame, der analysiert wird. Verwenden Sie das handle, das an die Parser-DLL im hFrame-Parameter der AttachProperties-Funktion übergeben wird.

hProperty [ In]

Handle für eine PROPERTYINFO-Struktur, die die -Eigenschaft definiert. Wenn Sie die Exportfunktion Register implementieren, geben Sie die PROPERTYINFO-Struktur an, die die Eigenschaft definiert.

Länge [ In]

Länge der Daten für diese Instanz der -Eigenschaft.

lpData [ In]

Zeiger auf die Position in den erkannten Daten, an der sich der Eigenschaftswert befindet. Verwenden Sie den Zeiger, der an die Parser-DLL im lpProtocol-Parameter der AttachProperties-Funktion übergeben wird.

HelpID [ In]

Bezeichner (von 0 bis 2047), der zum Festlegen der kontextsensitiven Hilfe für die Eigenschaft verwendet wird.

Die Bezeichnernummer ist relativ zur Hilfedatei, die der Protokolleigenschaftsdatenbank zugeordnet ist.

IndentLevel [ In]

Einzugsebene (von 0 bis 15), die verwendet wird, um eine Eigenschaft hierarchisch anzuzeigen.

Netzwerkmonitor verwendet die Ebenen 0 bis 14, um Eigenschaften eingerückt zu werden. Ebene 15 ist ein spezieller Wert, mit dem ein Parser eine ausgeblendete Eigenschaft anfügen kann, die nicht sichtbar ist.

IFlags [ In]

Ein BIT-Feldwert, der die Reihenfolge der BITs innerhalb einer Eigenschaft angibt. Vorherige Parser, die fError auf 0 oder 1 festlegen, sollten fError jetzt auf IFLAG _ ERROR festlegen. Legen Sie diesen Parameter auf einen der folgenden Werte fest.

Wert Bedeutung
_IFLAG-FEHLER
Daten im Frame haben einen Fehler.
IFLAG _ SWAPPED
Zum Zeitpunkt des Anfügens ist das WORD-Byte ein Nicht-Intel-Format.
IFLAG _ UNICODE
Zum Zeitpunkt des Anfügens ist STRING Unicode.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert TRUE.

Wenn die Funktion nicht erfolgreich ist, ist der Rückgabewert FALSE.

Hinweise

Die AttachPropertyInstance-Funktion wird während der Implementierung der AttachProperties-Exportfunktion aufgerufen. Wenn eine Eigenschaft an die Daten angefügt wird, erstellt Netzwerkmonitor PROPERTYINST-Struktur, die die Instanz der angefügten Eigenschaft definiert.

Rufen Sie während der Implementierung von AttachProperties AttachPropertyInstance auf, um die Daten so zu verwenden, wie sie in der Erfassung vorhanden sind. Sie können auch die AttachPropertyInstanceEx-Funktion aufrufen, um die Eigenschaftsdaten zu ändern. Es wird jedoch empfohlen, die Daten so zu verwenden, wie sie in der Erfassung vorhanden sind.

Informationen zu Siehe
Was Parser sind und wie sie mit Netzwerkmonitor. Parser
Aufrufen von AttachPropertyInstance. 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
Netmon.h
Bibliothek
Nmapi.lib
DLL
Nmapi.dll

Weitere Informationen

AttachProperties

AttachPropertyInstanceEx

PROPERTYINST