Funzione CreatePropertyDatabase

La funzione CreatePropertyDatabase crea un database di proprietà che archivia le proprietà di un protocollo.

Sintassi

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

Parametri

hProtocol [in]

Handle del protocollo associato al database. Quando Monitoraggio di rete chiama la funzione Register , Monitoraggio di rete passa l'handle di protocollo alla DLL del parser.

nProperties [in]

Numero di proprietà archiviate nel database. Impostare questo parametro sul numero di proprietà supportate dal protocollo.

Valore restituito

Se la funzione ha esito positivo, il valore restituito viene NMERR_SUCCESS.

Se la funzione ha esito negativo, il valore restituito è un codice di errore.

Codice restituito	Descrizione
NMERR_INTERNAL_ERROR	Si è verificato un errore interno.
NMERR_INVALID_HPOTOCOL	L'handle per il protocollo specificato in hProtocol non è valido.
NMERR_OUT_OF_MEMORY	Monitoraggio di rete non dispone di memoria sufficiente per creare il database.

Commenti

La funzione CreatePropertyDatabase deve essere chiamata solo quando si implementa la funzione Register . Il parser usa CreatePropertyDatabase per creare un database di proprietà che descrive le proprietà di un protocollo. Monitoraggio di rete usa il database per interpretare le informazioni all'interno del protocollo.

La funzione CreatePropertyDatabase alloca le strutture necessarie a Monitoraggio di rete per gestire un database di proprietà.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Intestazione	Netmon.h
Libreria	Nmapi.lib
DLL	Nmapi.dll

Vedi anche

Registra