AttachPropertyInstance-Funktion
Die AttachPropertyInstance-Funktion ordnet eine vorhandene Eigenschaft einem bestimmten Speicherort 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]
-
Behandeln Sie 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]
-
Die Länge der Daten für diese instance der Eigenschaft.
-
lpData [in]
-
Zeiger auf den Speicherort in den erkannten Daten, an dem 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 kontextabhängigen Hilfe für die Eigenschaft verwendet wird.
Die Bezeichnernummer ist relativ zur Hilfedatei, die der Protokolleigenschaftendatenbank zugeordnet ist.
-
IndentLevel [in]
-
Einzugsebene (von 0 bis 15), die verwendet wird, um eine Eigenschaft hierarchisch anzuzeigen.
Der Netzwerkmonitor verwendet die Ebenen 0 bis 14, um Eigenschaften einzugsaufzurücken. Ebene 15 ist ein besonderer 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. Frühere 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_ERROR
Daten im Frame haben einen Fehler. - IFLAG_SWAPPED
Zur Anfügungszeit ist das WORD-Byte ein Nicht-Intel-Format. - IFLAG_UNICODE
Zur Anfügungszeit 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.
Bemerkungen
Die AttachPropertyInstance-Funktion wird während der Implementierung der Exportfunktion AttachProperties aufgerufen. Wenn eine Eigenschaft an die Daten angefügt wird, erstellt Network Monitor eine PROPERTYINST-Struktur, die die instance der angefügten Eigenschaft definiert.
Rufen Sie während der Implementierung von AttachPropertiesAttachPropertyInstance auf, um die Daten so zu verwenden, wie sie in der Erfassung vorhanden sind. Sie können auch die AttachPropertyInstanceEx-Funktion aufrufen, um die Eigenschaftendaten 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 Dem Netzwerkmonitor arbeiten. | 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 |
|
| Bibliothek |
|
| DLL |
|