Funzione RasSecurityDialogBegin (rasshost.h)

  • Articolo

La funzione RasSecurityDialogBegin è un punto di ingresso della DLL di sicurezza RAS di terze parti che il server RAS chiama quando un utente remoto tenta di connettersi. Ciò consente alla DLL di sicurezza di avviare l'autenticazione dell'utente remoto.

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 RasSecurityDialogBegin(
  [in] HPORT                        hPort,
  [in] PBYTE                        pSendBuf,
  [in] DWORD                        SendBufSize,
  [in] PBYTE                        pRecvBuf,
  [in] DWORD                        RecvBufSize,
       VOID(* )(SECURITY_MESSAGE *) RasSecurityDialogComplete
);

Parametri

[in] hPort

Specifica un handle di porta RAS. La DLL di sicurezza usa questo handle in altre funzioni di sicurezza RAS, ad esempio RasSecurityDialogSend e RasSecurityDialogReceive, per identificare questa transazione di autenticazione.

Si noti che questo handle è valido solo nelle funzioni di sicurezza RAS; non usarlo in altre funzioni di I/O.

[in] pSendBuf

Puntatore a un buffer allocato dal server RAS. La DLL di sicurezza usa questo buffer con la funzione RasSecurityDialogSend per inviare testo visualizzato nella finestra del terminale RAS nel computer remoto.

[in] SendBufSize

Specifica le dimensioni, in byte, del buffer pSendBuf .

[in] pRecvBuf

Puntatore a un buffer allocato dal server RAS. La DLL di sicurezza usa questo buffer con la funzione RasSecurityDialogReceive per ricevere la risposta dall'utente remoto.

[in] RecvBufSize

Specifica le dimensioni, in byte, del buffer pRecvBuf .

RasSecurityDialogComplete

Valore restituito

Se la DLL di sicurezza avvia correttamente l'operazione di autenticazione, RasSecurityDialogBegin deve restituire NO_ERROR. In questo caso, la DLL di sicurezza deve terminare la transazione di autenticazione chiamando la funzione puntata dal parametro RasSecurityDialogComplete .

Se si verifica un errore, RasSecurityDialogBegin deve restituire un codice di errore diverso da zero. In questo caso, il server RAS blocca la chiamata e registra l'errore nel registro eventi. La restituzione di un codice di errore non zero termina la transazione di autenticazione, quindi la DLL di sicurezza non deve chiamare la funzione RasSecurityDialogComplete .

Commenti

Quando un server RAS riceve una chiamata da un computer remoto, chiama la funzione RasSecurityDialogBegin esportata dalla DLL di sicurezza RAS registrata, se presente. Quando il server RAS chiama questa funzione, passa le informazioni seguenti alla DLL di sicurezza:

  • Handle di porta per identificare la connessione
  • Puntatori ai buffer da usare quando si comunica con l'utente remoto
  • Puntatore alla funzione RasSecurityDialogComplete da chiamare al termine dell'autenticazione
L'handle della porta e i puntatori buffer sono validi fino a quando RasSecurityDialogComplete viene chiamato per terminare la transazione di autenticazione.

L'implementazione rasSecurityDialogBegin deve restituire il prima possibile, perché il server RAS viene bloccato e non può accettare altre chiamate fino a quando RasSecurityDialogBegin restituisce. La funzione RasSecurityDialogBegin deve copiare i parametri di input e creare un thread per comunicare con e autenticare l'utente remoto.

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

Vedi anche

Funzioni di amministrazione del server RAS

RasSecurityDialogComplete

RasSecurityDialogReceive

RasSecurityDialogSend

Panoramica del servizio di accesso remoto (RAS)