Função RasSecurityDialogBegin (rasshost.h)

Artigo
08/25/2023

A função RasSecurityDialogBegin é um ponto de entrada de DLL de segurança RAS de terceiros que o servidor RAS chama quando um usuário remoto tenta se conectar. Isso permite que a DLL de segurança inicie sua autenticação do usuário remoto.

Nota No momento, o Windows Server 2008, o Windows Server 2003, o Windows 2000 Server e o Windows NT Server 4.0 fornecem suporte a host de segurança RAS somente para dispositivos seriais. 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 RasSecurityDialogBegin(
  [in] HPORT                        hPort,
  [in] PBYTE                        pSendBuf,
  [in] DWORD                        SendBufSize,
  [in] PBYTE                        pRecvBuf,
  [in] DWORD                        RecvBufSize,
       VOID(* )(SECURITY_MESSAGE *) RasSecurityDialogComplete
);

Parâmetros

[in] hPort

Especifica um identificador de porta RAS. A DLL de segurança usa esse identificador em outras funções de segurança RAS, como RasSecurityDialogSend e RasSecurityDialogReceive, para identificar essa transação de autenticação.

Observe que esse identificador é válido apenas em funções de segurança RAS; não o use em outras funções de E/S.

[in] pSendBuf

Ponteiro para um buffer alocado pelo servidor RAS. A DLL de segurança usa esse buffer com a função RasSecurityDialogSend para enviar o texto exibido na janela do terminal RAS no computador remoto.

[in] SendBufSize

Especifica o tamanho, em bytes, do buffer pSendBuf .

[in] pRecvBuf

Ponteiro para um buffer alocado pelo servidor RAS. A DLL de segurança usa esse buffer com a função RasSecurityDialogReceive para receber a resposta do usuário remoto.

[in] RecvBufSize

Especifica o tamanho, em bytes, do buffer pRecvBuf .

RasSecurityDialogComplete

Retornar valor

Se a DLL de segurança iniciar com êxito a operação de autenticação, RasSecurityDialogBegin deverá retornar NO_ERROR. Nesse caso, a DLL de segurança deve encerrar posteriormente a transação de autenticação chamando a função apontada pelo parâmetro RasSecurityDialogComplete .

Se ocorrer um erro, RasSecurityDialogBegin deverá retornar um código de erro diferente de zero. Nesse caso, o servidor RAS trava a chamada e registra o erro no log de eventos. Retornar um código de erro diferente de zero encerra a transação de autenticação, portanto, a DLL de segurança não precisa chamar a função RasSecurityDialogComplete .

Comentários

Quando um servidor RAS recebe uma chamada de um computador remoto, ele chama a função RasSecurityDialogBegin exportada pela DLL de segurança RAS registrada, se houver uma. Quando o servidor RAS chama essa função, ele passa as seguintes informações para a DLL de segurança:

Um identificador de porta para identificar a conexão
Ponteiros para buffers a serem usados ao se comunicar com o usuário remoto
Um ponteiro para a função RasSecurityDialogComplete a ser chamada quando a autenticação tiver sido concluída

O identificador de porta e os ponteiros de buffer são válidos até que RasSecurityDialogComplete seja chamado para encerrar a transação de autenticação.

A implementação rasSecurityDialogBegin deve retornar o mais rápido possível, pois o servidor RAS está bloqueado e não pode aceitar nenhuma outra chamada até que RasSecurityDialogBegin retorne. A função RasSecurityDialogBegin deve copiar os parâmetros de entrada e criar um thread para se comunicar e autenticar o usuário remoto.

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