Compartilhar via

Função RasGetNapStatus (ras.h)

  • Artigo

A função RasGetNapStatus recupera as variáveis de estado de conexão NAP ( Proteção de Acesso à Rede ) para uma determinada conexão de acesso remoto.

Sintaxe

DWORD RasGetNapStatus(
  [in]      HRASCONN      hRasconn,
  [in, out] LPRASNAPSTATE pRasNapState
);

Parâmetros

[in] hRasconn

Um identificador para a conexão. Use RasDial ou RasEnumConnections para obter esse identificador.

[in, out] pRasNapState

Um ponteiro para uma estrutura RASNAPSTATE . Na entrada, o membro dwSize da estrutura deve ser definido como sizeof(RASNAPSTATE). Na saída, pNapState retorna o estado NAP da conexão RAS.

Retornar valor

Se a função for bem-sucedida, o valor retornado será ERROR_SUCCESS.

Se a função falhar, o valor retornado será um dos seguintes códigos de erro ou um valor de Códigos de Erro de Roteamento e Acesso Remoto ou Winerror.h.

Código de retorno Descrição
ERROR_NOT_NAP_CAPABLE
 A conexão correspondente ao parâmetro hRasConn não está configurada para NAP.
ERROR_INVALID_SIZE
 O parâmetro dwSize da estrutura RASNAPSTATE tem um valor de tamanho inválido.
ERROR_INVALID_HANDLE
 O identificador passado para a função é NULL ou inválido.
ERROR_NO_CONNECTION
 RASMAN não pôde encontrar o identificador em sua lista de identificadores.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho ras.h
Biblioteca Rasapi32.lib
DLL Rasapi32.dll