Função RasGetNapStatus (ras.h)

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