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 der Netzwerkmonitor die Register-Funktion aufruft, übergibt der Netzwerkmonitor das Protokollhandle an die Parser-DLL.
-
nEigenschaften [in]
-
Anzahl der in der Datenbank gespeicherten Eigenschaften. Legen Sie diesen Parameter auf die Anzahl von Eigenschaften fest, die vom Protokoll unterstützt werden.
Rückgabewert
Wenn die Funktion erfolgreich ist, wird der Rückgabewert NMERR_SUCCESS.
Wenn die Funktion nicht erfolgreich ist, ist der Rückgabewert ein Fehlercode.
| Rückgabecode | Beschreibung |
|---|---|
|
Ein interner Fehler ist aufgetreten. |
|
Das Handle für das in hProtocol angegebene Protokoll ist ungültig. |
|
Der Netzwerkmonitor verfügt nicht über genügend Arbeitsspeicher, um die Datenbank zu erstellen. |
Bemerkungen
Die CreatePropertyDatabase-Funktion sollte nur beim Implementieren der Register-Funktion aufgerufen werden. Der Parser verwendet CreatePropertyDatabase , um eine Eigenschaftendatenbank zu erstellen, die die Eigenschaften eines Protokolls beschreibt. Der Netzwerkmonitor verwendet die Datenbank, um die Informationen im Protokoll zu interpretieren.
Die CreatePropertyDatabase-Funktion ordnet die Strukturen zu, die der Netzwerkmonitor zum Verwalten einer Eigenschaftendatenbank benötigt.
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 |
|