Compartilhar via

Método IESP::Connect

  • Artigo

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

Sintaxe

HRESULT STDMETHODCALLTYPE Connect(
  [in]  HBLOB hInputBlob,
  [in]  DWORD StatusCallbackProc,
  [in]  DWORD 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 IESP::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 IESP::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 IESP::Connect ou IESP::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 IESP::Configure .
NMERR_BLOB_STRING_INVALID
 A cadeia de caracteres não é terminada em nulo. Esse erro é gerado pela chamada IESP::Configure .
NMERR_ILLEGAL_TRIGGER
 A parte do gatilho do BLOB de entrada está corrompida. Esse erro é gerado pela chamada IESP::Configure .
NMERR_INVALID_BLOB
 O objeto especificado em hInputBlob não é um BLOB. Esse erro é gerado pela chamada IESP::Configure .
NMERR_NO_DEFAULT_CAPTURE_DIRECTORY
 O diretório de captura padrão não foi definido no Registro. Use o caminho a seguir para definir o diretório de captura. 
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 está disponível. Esse erro é gerado pela chamada IESP::Configure .
NMERR_TIMEOUT
 A solicitação atingiu o tempo limite. Esse erro é gerado pela chamada IESP::Configure .
NMERR_UPLEVEL_BLOB
 O número de versão do BLOB especificado em hInputBlob está incorreto. Esse erro é gerado pela chamada IESP::Configure .

Comentários

Quando o método Connect é chamado, o Monitor de Rede chama automaticamente IESP::Configure usando o BLOB fornecido pelo parâmetro hInputBlob . Observe que todos os códigos de erro retornados pela chamada para IESP::Configure são passados de volta e retornados pela chamada IESP::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 IESP para capturar quadros.

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

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 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 uma NIC 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

IESP

IESP::Configure

IESP::D isconnect

IESP::Start