Função RasSecurityDialogGetInfo (rasshost.h)

Artigo
03/09/2024

A função RasSecurityDialogGetInfo é chamada por uma DLL de segurança ras para obter informações sobre uma porta do servidor RAS.

Para chamar essa função, primeiro chame a função LoadLibrary para carregar Rasman.dll. Em seguida, chame a função GetProcAddress para obter o ponto de entrada RasSecurityDialogGetInfo da DLL.

Nota O Windows Server 2008, o Windows Server 2003, o Windows 2000 Server e o Windows NT Server 4.0 atualmente fornecem suporte a host de segurança RAS apenas para dispositivos serial. Não há suporte para outros tipos de conexões, como ISDN (Rede Digital de Serviços Integrados) ou conexões VPN (rede virtual privada).

Sintaxe

DWORD RasSecurityDialogGetInfo(
  [in] HPORT             hPort,
  [in] RAS_SECURITY_INFO *pBuffer
);

Parâmetros

[in] hPort

Especifica o identificador de porta que o servidor RAS passou para a DLL de segurança na chamada RasSecurityDialogBegin para essa transação de autenticação.

[in] pBuffer

Ponteiro para a estrutura de RAS_SECURITY_INFO que recebe informações sobre a porta RAS especificada.

Retornar valor

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

Se a função falhar, o valor retornado será um dos códigos de erro definidos em Raserror.h ou Winerror.h. GetLastError não fornece informações de erro estendidas.

Comentários

A função RasSecurityDialogGetInfo recupera informações sobre a porta associada a uma transação de autenticação de DLL de segurança RAS.

O membro LastError da estrutura RAS_SECURITY_INFO indica o estado da última chamada RasSecurityDialogReceive para a porta. Se a operação de recebimento tiver sido concluída com êxito, LastError será SUCCESS e o membro BytesReceived indicará o número de bytes recebidos. Caso contrário, LastError estará PENDENTE se a operação de recebimento ainda estiver em andamento ou um código de erro diferente de zero se a operação de recebimento falhar.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	rasshost.h
DLL	Rasman.dll