Funzione RasGetSubEntryHandleA (ras.h)
La funzione RasGetSubEntryHandle recupera un handle di connessione per una sottoentry specificata di una connessione multilink.
Sintassi
DWORD RasGetSubEntryHandleA(
[in] HRASCONN unnamedParam1,
[in] DWORD unnamedParam2,
[out] LPHRASCONN unnamedParam3
);
Parametri
[in] unnamedParam1
Specifica l'handle di connessione HRASCONN restituito dalla funzione RasDial per una voce di rubrica multilink.
[in] unnamedParam2
Specifica un indice secondario valido per la voce della rubrica telefonica.
[out] unnamedParam3
Puntatore alla variabile HRASCONN che riceve un handle di connessione che rappresenta la connessione secondaria.
Valore restituito
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 da Routing e codici di errore di accesso remoto o Winerror.h.
Valore | Significato |
---|---|
|
L'handle di connessione hRasConn non rappresenta una voce di rubrica telefonica connessa. |
|
I parametri hRasConn e dwSubEntry sono validi, ma la sottoentria specificata non è connessa. |
|
Il valore specificato da dwSubEntry supera il numero massimo di voci secondarie per la voce della rubrica telefonica. |
Commenti
L'handle di connessione specificato nel parametro hRasConn fa riferimento all'intera connessione multilink, ma l'handle di connessione restituito nel parametro *lphRasConn fa riferimento solo alla connessione secondaria. Usare l'handle di connessione secondaria in qualsiasi funzione che accetta un parametro hRasConn , inclusi le funzioni RasHangUp, RasGetConnectStatus e RasGetProjectionInfoEx . Le informazioni di proiezione restituite da RasGetProjectionInfo per una voce multilink sono uguali per ogni handle di connessione secondaria, come per l'handle di connessione principale.
È possibile chiamare RasHangUp nell'handle restituito da RasGetSubEntryHandle per terminare un singolo collegamento in una connessione a più collegamenti. Tuttavia, 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 RasGetSubEntryHandle come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.
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 | ras.h |
Libreria | Rasapi32.lib |
DLL | Rasapi32.dll |