IRTC::Configure (método)

El método Configure envía datos de configuración para una captura de datos.

Sintaxis

HRESULT STDMETHODCALLTYPE Configure(
  [in]  HBLOB hConfigurationBlob,
  [out] HBLOB hErrorBlob
);

Parámetros

hConfigurationBlob [in]

Identificador del BLOB configurado por el autor de la llamada.

hErrorBlob [out]

Identificador de un BLOB de error que contiene datos de error adicionales.

Valor devuelto

Si el método se ejecuta correctamente, el valor devuelto se NMERR_SUCCESS.

Si el método no se realiza correctamente, el valor devuelto es uno de los siguientes códigos de error:

Código devuelto	Descripción
NMERR_BLOB_NOT_INITIALIZED	No se ha llamado al método CreateBlob .
NMERR_INVALID_BLOB	El objeto al que apunta no es un BLOB.
NMERR_UPLEVEL_BLOB	El número de versión de BLOB es incorrecto.
NMERR_BLOB_ENTRY_ALREADY_EXISTS	BLOB duplicado.
NMERR_BLOB_ENTRY_DOES_NOT_EXIST	El BLOB de configuración especificado por hConfigurationBlob carece de una entrada necesaria para realizar esta operación. Vea el error BLOB devuelto por hErrorBlob para determinar qué entrada no se encontró.
NMERR_AMBIGUOUS_SPECIFIER	Faltan los datos de propietario o categoría de BLOB.
NMERR_BLOB_OWNER_NOT_FOUND	No se encontró la sección Propietario de BLOB.
NMERR_BLOB_CATEGORY_NOT_FOUND	No se encontró la sección Categoría blob.
NMERR_UNKNOWN_CATEGORY	Se encontró la sección Categoría BLOB, pero no se entiende.
NMERR_UNKNOWN_TAG	Se encontró la sección Etiqueta BLOB, pero no se entiende.
NMERR_BLOB_CONVERSION_ERROR	El BLOB está dañado.
NMERR_ILLEGAL_TRIGGER	La parte del desencadenador del BLOB está dañada.
NMERR_BLOB_STRING_INVALID	La cadena no termina en null.

Comentarios

Debe aplicar este método para reiniciar un NPP que se ha iniciado, detenido, pero no desconectado.

El blob de error devuelto por hErrorBlob contiene entradas que Network Monitor no pudo entender ni encontrar en la configuración BLOB especificada en hConfigurationBlob. El BLOB de error devuelto contiene datos de error que la aplicación puede usar para solucionar problemas. Por ejemplo, si se devuelve NMERR_BLOB_ENTRY_DOES_NOT_EXIST, la entrada Network Monitor no se encuentra en el blob de error devuelto.

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
Archivo DLL	Ndisnpp.dll; Rmtnpp.dll

Consulte también

IRTC

IRTC::Connect

Network Monitor BLOBS