Função RasSecurityDialogSend (rasshost.h)

Artigo
03/13/2024

A função RasSecurityDialogSend envia uma mensagem a ser exibida em uma janela de terminal em um computador remoto. Uma DLL de segurança RAS de terceiros envia essa mensagem como parte de sua autenticação de um usuário remoto.

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 RasSecurityDialogSend 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 RasSecurityDialogSend(
  [in] HPORT hPort,
  [in] PBYTE pBuffer,
  [in] WORD  BufferLength
);

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 o buffer de envio que foi passado para a DLL de segurança na chamada para RasSecurityDialogBegin. Antes de chamar RasSecurityDialogSend, copie para esse buffer a mensagem a ser enviada ao usuário remoto. O parâmetro SendBufSize da função RasSecurityDialogBegin indica o número máximo de bytes que o buffer pode armazenar.

[in] BufferLength

Especifica o número de bytes a serem enviados no buffer pBuffer .

Retornar valor

Se a função for bem-sucedida, o valor retornado será PENDING (definido em Raserror.h). Isso indica que a operação de envio está em andamento.

Se ocorrer um erro, 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 RasSecurityDialogSend é assíncrona. Depois de chamá-la para enviar uma mensagem ao usuário remoto, chame a função RasSecurityDialogReceive e aguarde uma resposta. A DLL de segurança pode fazer qualquer número de chamadas RasSecurityDialogSend , com cada chamada seguida por uma chamada RasSecurityDialogReceive .

Quando uma DLL de segurança está autenticando um usuário remoto, a operação de conexão no computador remoto entra em um estado RASCS_Interactive pausado. A mensagem enviada por RasSecurityDialogSend é exibida como saída em uma janela de terminal no computador remoto. A resposta recebida por RasSecurityDialogReceive é a entrada que o usuário remoto digita na janela do terminal. O valor RASCS_Interactive é definido na enumeração RASCONNSTATE .

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