Função NPGetConnection (npapi.h)

  • Artigo

Recupera informações sobre uma conexão.

Sintaxe

DWORD NPGetConnection(
  [in]      LPWSTR  lpLocalName,
  [out]     LPWSTR  lpRemoteName,
  [in, out] LPDWORD lpnBufferLen
);

Parâmetros

[in] lpLocalName

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

[out] lpRemoteName

Ponteiro para um buffer que receberá o nome remoto usado para fazer a conexão. Esse buffer é alocado pelo chamador.

[in, out] lpnBufferLen

Ponteiro para o tamanho, em caracteres, do buffer lpRemoteName . 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. Caso contrário, ele deverá retornar um código de erro, que pode ser um dos seguintes:

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

A função NPGetConnection pode retornar informações apenas sobre uma conexão de rede conectada no momento. Para recuperar informações sobre uma conexão de rede que está desconectada no momento, use NPGetConnection3.

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