Función CreatePropertyDatabase

La función CreatePropertyDatabase crea una base de datos de propiedades que almacena las propiedades de un protocolo.

Sintaxis

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

Parámetros

hProtocol [in]

Identificador del protocolo asociado a la base de datos. Cuando Network Monitor llama a la función Register , Network Monitor pasa el identificador de protocolo al archivo DLL del analizador.

nProperties [in]

Número de propiedades almacenadas en la base de datos. Establezca este parámetro en el número de propiedades que admite el protocolo.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es NMERR_SUCCESS.

Si la función no se realiza correctamente, el valor devuelto es un código de error.

Código devuelto	Descripción
NMERR_INTERNAL_ERROR	Se ha producido un error interno.
NMERR_INVALID_HPOTOCOL	El identificador del protocolo especificado en hProtocol no es válido.
NMERR_OUT_OF_MEMORY	Network Monitor no tiene suficiente memoria para crear la base de datos.

Comentarios

Solo se debe llamar a la función CreatePropertyDatabase al implementar la función Register . El analizador usa CreatePropertyDatabase para crear una base de datos de propiedades que describa las propiedades de un protocolo. Network Monitor usa la base de datos para interpretar la información dentro del protocolo.

La función CreatePropertyDatabase asigna las estructuras que Network Monitor necesita para mantener una base de datos de propiedades.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Encabezado	Netmon.h
Biblioteca	Nmapi.lib
Archivo DLL	Nmapi.dll

Consulte también

Registro