Funzione RasGetSubEntryHandleA (ras.h)

Articolo
11/20/2024

La funzione RasGetSubEntryHandle recupera un handle di connessione per una sottosezione 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 telefonica 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 di Codici di errore di routing e 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 sottoentità 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.

Osservazioni

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 secondario in qualsiasi funzione che accetta un parametro hRasConn, incluso il RasHangUp, RasGetConnectStatuse funzioni rasGetProjectionInfoEx. Le informazioni di proiezione restituite da RasGetProjectionInfo per una voce multilink sono le stesse per ogni handle di connessione secondaria così come per l'handle di connessione principale.

È possibile chiamare RasHangUp sull'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 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.

Fabbisogno

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