Método IDelaydC::Connect

  • Artigo

O método Connect conecta o NPP à rede usando um adaptador de rede especificado cartão e fornece informações de configuração sobre 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 você está se conectando e as informações de configuração sobre essa conexão.

StatusCallbackProc [in]

Endereço da função de retorno de chamada do usuário, que é usada para receber atualizações status, como gatilhos. Se nenhuma função de retorno de chamada 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]

Manipule para um BLOB de erro que contém informações de erro adicionais.

Valor retornado

Se esse 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 IDelaydC::Configure ):

Código de retorno Descrição
NMERR_ALREADY_CONNECTED
 Essa instância do objeto COM do NPP já está conectada à rede.
NMERR_BLOB_CONVERSION_ERROR
 O BLOB de configuração está corrompido. Esse erro é gerado pela chamada IDelaydC::Configure .
NMERR_BLOB_ENTRY_DOES_NOT_EXIST
 O BLOB de entrada especificado por hInputBlob não tem uma entrada necessária para executar essa operação. Esse erro pode ser gerado pela chamada IDelaydC::Connect ou IDelaydC::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 IDelaydC::Configure .
NMERR_BLOB_STRING_INVALID
 A cadeia de caracteres não é terminada em nulo. Esse erro é gerado pela chamada IDelaydC::Configure .
NMERR_ILLEGAL_TRIGGER
 A parte do gatilho do BLOB de entrada está corrompida. Esse erro é gerado pela chamada IDelaydC::Configure .
NMERR_INVALID_BLOB
 O objeto especificado em hInputBlob não é um BLOB. Esse erro é gerado pela chamada IDelaydC::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
 Nenhuma memória estava disponível para executar essa operação. Esse erro é gerado pela chamada IDelaydC::Configure .
NMERR_TIMEOUT
 A solicitação atingiu o tempo limite. Esse erro é gerado pela chamada IDelaydC::Configure .
NMERR_UPLEVEL_BLOB
 O número de versão do BLOB especificado em hInputBlob está incorreto. Esse erro é gerado pela chamada IDelaydC::Configure .

Comentários

Quando o método Connect é chamado, o NPP chama automaticamente IDelaydC::Configure usando o BLOB fornecido por hInputBlob. Observe que todos os códigos de erro retornados pela chamada para IDelaydC::Configure são passados de volta e retornados pela chamada IDelaydC::Connect .

Esse método deve ser chamado antes que você possa começar a capturar quadros. Observe que, ao se conectar à rede usando esse método, você deve continuar a usar os métodos de interface IDelaydC para capturar quadros.

O BLOB de entrada especificado pelo parâmetro hInputBlob pode ser obtido chamando GetNPPBlobFromUI, GetNPPBlobTable e SelectNPPBlobFromTable.

O BLOB de erro retornado no hErrorBlob contém informações de erro que o desenvolvedor ou o aplicativo podem usar para solução de problemas. 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. 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.

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

IDelaydC

IDelaydC::Configure

IDelaydC::D isconnect

IDelaydC::Start