CreatePropertyDatabase-Funktion

Die CreatePropertyDatabase-Funktion erstellt eine Eigenschaftendatenbank, in der die Eigenschaften eines Protokolls gespeichert werden.

Syntax

DWORD WINAPI CreatePropertyDatabase(
  _In_ HPROTOCOL hProtocol,
  _In_ DWORD     nProperties
);

Parameter

hProtocol [ In]

Handle des Protokolls, das der Datenbank zugeordnet ist. Wenn Netzwerkmonitor die Register-Funktion aufruft, übergibt Netzwerkmonitor Protokollhand handle an die Parser-DLL.

nEigenschaften [ In]

Anzahl der in der Datenbank gespeicherten Eigenschaften. Legen Sie diesen Parameter auf die Anzahl der Eigenschaften fest, die das Protokoll unterstützt.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert NMERR _ SUCCESS.

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

Rückgabecode Beschreibung
INTERNER _ NMERR-FEHLER _
Ein interner Fehler ist aufgetreten.
NMERR _ INVALID _ HPTOMCOL
Das Handle für das in hProtocol angegebene Protokoll ist ungültig.
NMERR _ NICHT _ GENÜGEND _ ARBEITSSPEICHER
Netzwerkmonitor nicht über genügend Arbeitsspeicher zum Erstellen der Datenbank verfügt.

Hinweise

Die CreatePropertyDatabase-Funktion sollte nur aufgerufen werden, wenn die Register-Funktion implementieren wird. Der Parser verwendet CreatePropertyDatabase, um eine Eigenschaftendatenbank zu erstellen, die die Eigenschaften eines Protokolls beschreibt. Netzwerkmonitor verwendet die Datenbank, um die Informationen innerhalb des Protokolls zu interpretieren.

Die CreatePropertyDatabase-Funktion ordnet die Strukturen zu, Netzwerkmonitor eine Eigenschaftendatenbank verwalten müssen.

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

Siehe auch

Registrieren