Método IStats::Connect

O método Connect conecta o NPP à rede usando uma NIC especificada e fornece informações de configuração para a conexão.

Sintaxe

HRESULT STDMETHODCALLTYPE Connect(
  [in]  HBLOB  hInputBlob,
  [in]  LPVOID StatusCallbackProc,
  [in]  LPVOID UserContext,
  [out] HBLOB  hErrorBlob
);

Parâmetros

hInputBlob [in]

Manipule para o BLOB que especifica a NIC à qual o NPP se conecta e as informações de configuração para essa conexão.

StatusCallbackProc [in]

Endereço da função de retorno de chamada do usuário, que recebe status atualizações, como gatilhos. Se uma função de retorno de chamada não for usada, defina esse parâmetro e o parâmetro UserContext como NULL.

UserContext [in]

Valor passado quando a função de retorno de chamada do usuário é chamada. O valor desse parâmetro normalmente é HWND ou um ponteiro 'this'. Se uma função de retorno de chamada não for especificada, defina esse parâmetro e o parâmetro StatusCallbackProc como NULL.

hErrorBlob [out]

Identificador 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 (que incluem os erros retornados pela chamada interna IStats::Configure ):

Código de retorno	Descrição
NMERR_ALREADY_CONNECTED	Essa instância do objeto COM NPP já está conectada à rede.
NMERR_BLOB_CONVERSION_ERROR	O BLOB de configuração está corrompido. Esse erro é gerado pela chamada IStats::Configure .
NMERR_BLOB_ENTRY_DOES_NOT_EXIST	O BLOB de entrada especificado pelo parâmetro hInputBlob não tem uma entrada necessária para executar essa operação. Esse erro pode ser gerado pela chamada IStats::Connect ou IStats::Configure . Examine o erro BLOB retornado por hErrorBlob para determinar qual entrada não foi encontrada.
NMERR_BLOB_NOT_INITIALIZED	A função CreateBlob não foi chamada. Esse erro é gerado pela chamada IStats::Configure .
NMERR_BLOB_STRING_INVALID	A cadeia de caracteres não é terminada em nulo. Esse erro é gerado pela chamada IStats::Configure .
NMERR_ILLEGAL_TRIGGER	A parte do gatilho do BLOB de entrada está corrompida. Esse erro é gerado pela chamada IStats::Configure .
NMERR_INVALID_BLOB	O objeto especificado em hInputBlob não é um BLOB. Esse erro é gerado pela chamada IStats::Configure .
NMERR_NO_DEFAULT_CAPTURE_DIRECTORY	O diretório de captura padrão não foi definido no Registro. Para definir o diretório de captura, use o caminho a seguir. HKEY_LOCAL_MACHINE\System\CurrentControlSet\Services\nm\Parameters\CapturePath
NMERR_OUT_OF_MEMORY	A memória necessária para executar essa operação não estava disponível. Esse erro é gerado pela chamada IStats::Configure .
NMERR_TIMEOUT	A solicitação atingiu o tempo limite. Esse erro é gerado pela chamada IStats::Configure .
NMERR_UPLEVEL_BLOB	O número de versão do BLOB especificado em hInputBlob está incorreto. Esse erro é gerado pela chamada IStats::Configure .

Comentários

Quando o método Connect é chamado, o Monitor de Rede chama automaticamente o método IStats::Configure usando o BLOB fornecido pelo parâmetro hInputBlob . Observe que todos os códigos de erro retornados pela chamada para IStats::Configure são passados de volta e retornados pela chamada IStats::Connect .

Esse método deve ser chamado antes que você possa iniciar a captura de quadros. Observe que, ao se conectar à rede usando esse método, você deve continuar a usar a interface IStats para capturar quadros.

O BLOB de entrada especificado por hInputBlob pode ser obtido chamando os métodos GetNPPBlobFromUI, GetNPPBlobTable e SelectNPPBlobFromTable .

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 entrada especificado em hInputBlob. 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, a entrada que o Monitor de Rede não pôde encontrar será incluída no BLOB de erro retornado.

Para obter informações sobre	Consulte
Obtendo o BLOB de entrada que representa um adaptador de rede cartão	Selecionando uma placa de adaptador de rede

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::Configure

IStats::D isconnect

BLOBS do Monitor de Rede