IStats::Configure (método)

El método Configure envía información de configuración de captura.

Sintaxis

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

Parámetros

hConfigurationBlob [in]

Controle al BLOB que configura el autor de la llamada.

hErrorBlob [out]

Identificador de un BLOB de error que contiene información de error adicional.

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_STRING_INVALID	La cadena no termina en null.
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	Ya existe una entrada BLOB.
NMERR_BLOB_ENTRY_DOES_NOT_EXIST	El BLOB de configuración especificado por el parámetro hConfigurationBlob carece de una entrada necesaria para realizar esta operación. Examine el error BLOB devuelto por el parámetro hErrorBlob para determinar qué entrada no se encontró.
NMERR_AMBIGUOUS_SPECIFIER	El BLOB carece de información de propietario o categoría.
NMERR_BLOB_OWNER_NOT_FOUND	No se encontró la sección Propietario del BLOB.
NMERR_BLOB_CATEGORY_NOT_FOUND	No se encontró la sección Categoría del BLOB.
NMERR_UNKNOWN_CATEGORY	Se encontró información de categoría, pero no se entendió.
NMERR_UNKNOWN_TAG	Se encontró información de etiquetas, pero no se entendió.
NMERR_BLOB_CONVERSION_ERROR	El BLOB está dañado.
NMERR_ILLEGAL_TRIGGER	La parte del desencadenador del BLOB está dañada.

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 el parámetro hConfigurationBlob . El BLOB de error devuelto contiene información 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

IStats

ISTATS::Connect

Network Monitor BLOBS