Compartilhar via

Método IESP::Configure

  • Artigo

O método Configure envia informações de configuração para uma captura.

Sintaxe

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

Parâmetros

hConfigurationBlob [in]

Manipule para o BLOB configurado pelo chamador.

hErrorBlob [out]

Manipule para um BLOB de erro que contém informações de erro adicionais. Para obter informações sobre o conteúdo de um BLOB de erro, consulte a seção Comentários neste tópico.

Valor retornado

Se o método for bem-sucedido, o valor retornado será NMERR_SUCCESS.

Se o método não for bem-sucedido, o valor retornado será um dos seguintes códigos de erro:

Código de retorno Descrição
NMERR_NOT_CONNECTED
 O NPP não está conectado à rede.
NMERR_NOT_ESP
 O NPP está conectado à rede, mas não com o método IESP::Connect .
NMERR_CAPTURING
 O NPP relata que a sessão de captura foi iniciada.
NMERR_ILLEGAL_TRIGGER
 A parte do gatilho do BLOB de configuração está corrompida.
NMERR_BLOB_ENTRY_DOES_NOT_EXIST
 O BLOB de configuração especificado por hConfigurationBlob não tem uma entrada necessária para executar essa operação. Examine o erro BLOB retornado por hErrorBlob para determinar qual entrada não foi encontrada.
NMERR_BLOB_CONVERSION_ERROR
 O BLOB está corrompido.
NMERR_BLOB_NOT_INITIALIZED
 O método CreateBlob não foi chamado.
NMERR_INVALID_BLOB
 O objeto que é apontado não é um BLOB.
NMERR_BLOB_STRING_INVALID
 A cadeia de caracteres não é terminada em nulo.
NMERR_UPLEVEL_BLOB
 O número de versão do BLOB está incorreto.
NMERR_OUT_OF_MEMORY
 Nenhuma memória estava disponível. Desligue as janelas para liberar recursos.
NMERR_TIMEOUT
 O tempo limite da solicitação foi atingido.

Comentários

Você deve aplicar esse método para reiniciar um NPP que foi iniciado e interrompido, mas não desconectado.

O BLOB de erro retornado pelo parâmetro hErrorBlob contém entradas que o Monitor de Rede não pôde entender ou localizar no BLOB de configuração especificado em hConfigurationBlob. O BLOB de erro retornado contém informações de erro que o aplicativo pode usar para solução de problemas. Por exemplo, se NMERR_BLOB_ENTRY_DOES_NOT_EXIST for retornado, o Monitor de Rede de entrada não pôde localizar será incluído no BLOB de erro retornado.

Requisitos

Requisito Valor
Cliente mínimo com suporte
 Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte
 Windows 2000 Server [somente aplicativos da área de trabalho]
Cabeçalho
Netmon.h
DLL
Ndisnpp.dll;
Rmtnpp.dll