Método IRTC::Configure

O método Configure envia dados de configuração para uma captura de dados.

Sintaxe

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

Parâmetros

hConfigurationBlob [in]

Um identificador para o BLOB configurado pelo chamador.

hErrorBlob [out]

Um identificador para um BLOB de erro que contém dados 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_NOT_INITIALIZED	O método CreateBlob não foi chamado.
NMERR_INVALID_BLOB	O objeto apontado não é um BLOB.
NMERR_UPLEVEL_BLOB	O número de versão do BLOB está incorreto.
NMERR_BLOB_ENTRY_ALREADY_EXISTS	BLOB duplicado.
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. Exiba o erro BLOB retornado por hErrorBlob para determinar qual entrada não foi encontrada.
NMERR_AMBIGUOUS_SPECIFIER	Os dados de Proprietário ou Categoria do BLOB estão ausentes.
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 blob não foi encontrada.
NMERR_UNKNOWN_CATEGORY	A seção Categoria blob foi encontrada, mas não compreendida.
NMERR_UNKNOWN_TAG	A seção Marca BLOB foi encontrada, mas não foi compreendida.
NMERR_BLOB_CONVERSION_ERROR	O BLOB está corrompido.
NMERR_ILLEGAL_TRIGGER	A parte do gatilho do BLOB está corrompida.
NMERR_BLOB_STRING_INVALID	A cadeia de caracteres não é terminada em nulo.

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 em hConfigurationBlob. O BLOB de erro retornado contém dados de erro que o aplicativo pode usar para solução de problemas. Por exemplo, se NMERR_BLOB_ENTRY_DOES_NOT_EXIST for retornado, a entrada Monitor de Rede não poderá localizar será incluída 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

IRTC

IRTC::Connect

BLOBS do Monitor de Rede