Função NPGetConnection3 (npapi.h)

  • Artigo

Recupera informações sobre uma conexão de rede, mesmo que ela esteja desconectada no momento.

Sintaxe

DWORD NPGetConnection3(
  [in]      LPCWSTR lpLocalName,
  [in]      DWORD   dwLevel,
  [out]     LPVOID  lpBuffer,
  [in, out] LPDWORD lpBufferSize
);

Parâmetros

[in] lpLocalName

Ponteiro para o nome do dispositivo local no qual o chamador está interessado. O provedor pode assumir que isso é sintaticamente válido.

[in] dwLevel

Valor que especifica se a conexão de rede está conectada ou desconectada no momento.

Valor Significado
WNGETCON_CONNECTED
 A conexão de rede está conectada.
WNGETCON_DISCONNECTED
 A conexão de rede está desconectada.

[out] lpBuffer

Ponteiro void que recebe um buffer que contém as informações solicitadas.

[in, out] lpBufferSize

Ponteiro para o tamanho, em caracteres, do buffer lpBuffer . Se a chamada falhar porque o buffer não é grande o suficiente, lpBufferSize será definido como o tamanho do buffer necessário.

Retornar valor

Se a função for bem-sucedida, ela deverá retornar WN_SUCCESS.

Se a função falhar, ela deverá retornar um dos valores a seguir.

Código de retorno Descrição
WN_NOT_CONNECTED
 O dispositivo especificado por lpLocalName não é redirecionado por esse provedor.
WN_MORE_DATA
 O buffer era muito pequeno para receber todos os dados.
WN_NO_NETWORK
 A rede não está presente.

Comentários

Uma conexão de rede pode existir em três estados: conectado, desconectado e indisponível. A função NPGetConnection3 não pode recuperar informações sobre conexões de rede que estão indisponíveis no momento. No entanto, ele pode recuperar informações sobre conexões de rede que estão desconectadas no momento porque o Windows armazena as informações de conexão.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho npapi.h