Método IStats::Configure

O método Configure envia informações de configuração de 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.

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_BLOB_STRING_INVALID	A cadeia de caracteres não é terminada em nulo.
NMERR_BLOB_NOT_INITIALIZED	O método CreateBlob não foi chamado.
NMERR_INVALID_BLOB	O objeto que é apontado não é um BLOB.
NMERR_UPLEVEL_BLOB	O número de versão do BLOB está incorreto.
NMERR_BLOB_ENTRY_ALREADY_EXISTS	Uma entrada BLOB já existe.
NMERR_BLOB_ENTRY_DOES_NOT_EXIST	O BLOB de configuração especificado pelo parâmetro hConfigurationBlob não tem uma entrada necessária para executar essa operação. Examine o erro BLOB retornado pelo parâmetro hErrorBlob para determinar qual entrada não foi encontrada.
NMERR_AMBIGUOUS_SPECIFIER	O BLOB não tem informações de proprietário ou categoria.
NMERR_BLOB_OWNER_NOT_FOUND	A seção Proprietário do BLOB não foi encontrada.
NMERR_BLOB_CATEGORY_NOT_FOUND	A seção Categoria do BLOB não foi encontrada.
NMERR_UNKNOWN_CATEGORY	As informações da categoria foram encontradas, mas não foram compreendidas.
NMERR_UNKNOWN_TAG	As informações da marca foram encontradas, mas não foram compreendidas.
NMERR_BLOB_CONVERSION_ERROR	O BLOB está corrompido.
NMERR_ILLEGAL_TRIGGER	A parte do gatilho do BLOB está corrompida.

Comentários

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

O BLOB de erro retornado por hErrorBlob contém entradas que o Monitor de Rede não pôde entender ou localizar no BLOB de configuração especificado no parâmetro 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

Confira também

IStats

ISTATS::Connect

BLOBS do Monitor de Rede