Funzione RasGetSubEntryHandleA (ras.h)

Articolo
03/05/2024

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
ERROR_INVALID_HANDLE	L'handle di connessione hRasConn non rappresenta una voce di rubrica telefonica connessa.
ERROR_PORT_NOT_OPEN	I parametri hRasConn e dwSubEntry sono validi, ma la sottoentria specificata non è connessa.
ERROR_NO_MORE_ITEMS	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