Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
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.
| Value | Meaning |
|---|---|
|
A conexão de rede está conectada. |
|
A conexão de rede está desconectada. |
[out] lpBuffer
Ponteiro nulo 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 é definido como o tamanho do buffer necessário.
Valor de retorno
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 | Description |
|---|---|
|
O dispositivo especificado por lpLocalName não é redirecionado por esse provedor. |
|
O buffer era muito pequeno para receber todos os dados. |
|
A rede não está presente. |
Observações
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.
Requirements
| Requirement | Value |
|---|---|
| Cliente mínimo suportado | Windows XP [somente aplicativos da área de trabalho] |
| Servidor mínimo compatível | Windows Server 2003 [somente aplicativos da área de trabalho] |
| da Plataforma de Destino |
Windows |
| Header | npapi.h |
| Library | nanosrv.lib |