Funzione RasSecurityDialogGetInfo (rasshost.h)

Articolo
03/01/2024

La funzione RasSecurityDialogGetInfo viene chiamata da una DLL di sicurezza RAS per ottenere informazioni su una porta dal server RAS.

Per chiamare questa funzione, chiamare prima la funzione LoadLibrary per caricare Rasman.dll. Chiamare quindi la funzione GetProcAddress per ottenere il punto di ingresso RasSecurityDialogGetInfo 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 RasSecurityDialogGetInfo(
  [in] HPORT             hPort,
  [in] RAS_SECURITY_INFO *pBuffer
);

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 alla struttura RAS_SECURITY_INFO che riceve informazioni sulla porta RAS specificata.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è NO_ERROR.

Se la funzione ha esito negativo, 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 RasSecurityDialogGetInfo recupera informazioni sulla porta associata a una transazione di autenticazione DLL di sicurezza RAS.

Il membro LastError della struttura RAS_SECURITY_INFO indica lo stato dell'ultima chiamata RasSecurityDialogReceive per la porta. Se l'operazione di ricezione è stata completata correttamente, LastError è SUCCESS e il membro BytesReceived indica il numero di byte ricevuti. In caso contrario, LastError è IN SOSPESo se l'operazione di ricezione è ancora in corso o un codice di errore diverso da zero se l'operazione di ricezione non è riuscita.

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