Funzione RasSecurityDialogSend (rasshost.h)

Articolo
08/25/2023

La funzione RasSecurityDialogSend invia un messaggio da visualizzare in una finestra del terminale in un computer remoto. Una DLL di sicurezza RAS di terze parti invia questo messaggio come parte dell'autenticazione di un utente remoto.

Per chiamare questa funzione, chiamare prima la funzione LoadLibrary per caricare Rasman.dll. Chiamare quindi la funzione GetProcAddress per ottenere il punto di ingresso RasSecurityDialogSend della DLL.

Nota Windows Server 2008, Windows Server 2003, Windows 2000 Server e Windows NT Server 4.0 attualmente forniscono il supporto dell'host di sicurezza RAS solo per i dispositivi seriali. Non sono supportati altri tipi di connessioni, ad esempio Integrated Services Digital Network (ISDN) o reti private virtuali (VPN).

Sintassi

DWORD RasSecurityDialogSend(
  [in] HPORT hPort,
  [in] PBYTE pBuffer,
  [in] WORD  BufferLength
);

Parametri

[in] hPort

Specifica l'handle di porta passato al server RAS alla DLL di sicurezza nella chiamata RasSecurityDialogBegin per questa transazione di autenticazione.

[in] pBuffer

Puntatore al buffer di invio passato alla DLL di sicurezza nella chiamata a RasSecurityDialogBegin. Prima di chiamare RasSecurityDialogSend, copiare in questo buffer il messaggio da inviare all'utente remoto. Il parametro SendBufSize della funzione RasSecurityDialogBegin indica il numero massimo di byte che il buffer può archiviare.

[in] BufferLength

Specifica il numero di byte da inviare nel buffer pBuffer .

Valore restituito

Se la funzione ha esito positivo, il valore restituito è IN SOSPESo (definito in Raserror.h). Ciò indica che l'operazione di invio è in corso.

Se si verifica un errore, il valore restituito è uno dei codici di errore definiti in Raserror.h o Winerror.h. GetLastError non fornisce informazioni di errore estese.

Commenti

La funzione RasSecurityDialogSend è asincrona. Dopo aver chiamato per inviare un messaggio all'utente remoto, chiamare la funzione RasSecurityDialogReceive e quindi attendere una risposta. La DLL di sicurezza può effettuare qualsiasi numero di chiamate RasSecurityDialogSend , con ogni chiamata seguita da una chiamata RasSecurityDialogReceive .

Quando una DLL di sicurezza esegue l'autenticazione di un utente remoto, l'operazione di connessione nel computer remoto immette uno stato RASCS_Interactive sospeso. Il messaggio inviato da RasSecurityDialogSend viene visualizzato come output in una finestra del terminale nel computer remoto. La risposta ricevuta da RasSecurityDialogReceive è l'input che l'utente remoto digita nella finestra del terminale. Il valore RASCS_Interactive viene definito nell'enumerazione RASCONNSTATE .

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	rasshost.h
DLL	Rasman.dll