Funzione RasHangUpA (ras.h)
La funzione RasHangUp termina una connessione di accesso remoto. La connessione viene specificata con un handle di connessione RAS. La funzione rilascia tutte le risorse RASAPI32.DLL associate all'handle.
DWORD RasHangUpA(
[in] HRASCONN unnamedParam1
);
[in] unnamedParam1
Specifica la connessione di accesso remoto da terminare. Si tratta di un handle restituito da una chiamata precedente a RasDial o RasEnumConnections.
Se la funzione ha esito positivo, il valore restituito è ERROR_SUCCESS.
Se la funzione ha esito negativo, il valore restituito è uno dei codici di errore seguenti o un valore di Codici di errore di routing e accesso remoto o Winerror.h.
Valore | Significato |
---|---|
|
L'handle specificato in hrasconn non è valido. |
La connessione viene terminata anche se la chiamata RasDial non è ancora stata completata.
Dopo questa chiamata, l'handle hrasconn non può più essere usato.
Un'applicazione non deve chiamare RasHangUp e quindi uscire immediatamente. La macchina a stati della connessione richiede tempo per terminare correttamente. Se il sistema termina prematuramente la macchina a stati, la macchina a stati può non chiudere correttamente una porta, lasciando la porta in uno stato incoerente. Inoltre, un tentativo immediato di usare la stessa connessione potrebbe non riuscire a lasciare inutilizzabile la connessione. Un modo semplice per evitare questi problemi è chiamare Sleep(3000) dopo il ritorno da RasHangUp; dopo tale pausa, l'applicazione può uscire. Un modo più reattivo per evitare questi problemi è che, dopo aver restituito da RasHangUp, per chiamare RasGetConnectStatus(hrasconn) e Sleep(0) in un ciclo fino a quando RasGetConnectStatus restituisce ERROR_INVALID_HANDLE.
È possibile chiamare RasHangUp sull'handle restituito da RasGetSubEntryHandle per terminare un singolo collegamento in una connessione a più collegamenti. Tuttavia, in questo caso, non è possibile usare RasGetConnectStatus per determinare se il collegamento è terminato; RasGetConnectStatus potrebbe non restituire ERROR_INVALID_HANDLE anche se il collegamento è stato terminato correttamente.
Nota
L'intestazione ras.h definisce RasHangUp come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.
Requisito | Valore |
---|---|
client minimo supportato | Windows 2000 Professional [solo app desktop] |
server minimo supportato | Windows 2000 Server [solo app desktop] |
piattaforma di destinazione | Finestre |
intestazione |
ras.h |
libreria |
Rasapi32.lib |
dll | Rasapi32.dll |
Panoramica servizio di accesso remoto (RAS)