Compartir a través de

IESP::Configure (método)

  • Artículo

El método Configure envía información de configuración para una 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. Para obtener información sobre el contenido de un BLOB de error, vea la sección Comentarios de este tema.

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_NOT_CONNECTED
 El NPP no está conectado a la red.
NMERR_NOT_ESP
 El NPP está conectado a la red, pero no con el método IESP::Connect .
NMERR_CAPTURING
 El NPP informa de que se ha iniciado la sesión de captura.
NMERR_ILLEGAL_TRIGGER
 La parte del desencadenador del BLOB de configuración está dañada.
NMERR_BLOB_ENTRY_DOES_NOT_EXIST
 Falta una entrada necesaria para realizar esta operación en la configuración BLOB especificada por hConfigurationBlob . Examine el error BLOB devuelto por hErrorBlob para determinar qué entrada no se encontró.
NMERR_BLOB_CONVERSION_ERROR
 El BLOB está dañado.
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_BLOB_STRING_INVALID
 La cadena no termina en null.
NMERR_UPLEVEL_BLOB
 El número de versión de BLOB es incorrecto.
NMERR_OUT_OF_MEMORY
 No había memoria disponible. Apague ventanas para liberar recursos.
NMERR_TIMEOUT
 La solicitud ha agotado el tiempo de espera.

Observaciones

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

El blob de error devuelto por el parámetro 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 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