Funzione WTSConnectSessionA (wtsapi32.h)

Articolo
08/28/2023

Connette una sessione di Servizi Desktop remoto a una sessione esistente nel computer locale.

Sintassi

BOOL WTSConnectSessionA(
  [in] ULONG LogonId,
  [in] ULONG TargetLogonId,
  [in] PSTR  pPassword,
  [in] BOOL  bWait
);

Parametri

[in] LogonId

ID di accesso della sessione a cui connettersi. L'utente di tale sessione deve disporre delle autorizzazioni per connettersi a una sessione esistente. L'output di questa sessione verrà indirizzato alla sessione identificata dal parametro TargetLogonId .

Può essere LOGONID_CURRENT per usare la sessione corrente.

[in] TargetLogonId

ID di accesso della sessione per ricevere l'output della sessione rappresentata dal parametro LogonId . L'output della sessione identificato dal parametro LogonId verrà indirizzato a questa sessione.

Può essere LOGONID_CURRENT per usare la sessione corrente.

[in] pPassword

Puntatore alla password per l'account utente specificato nel parametro LogonId . Il valore di pPassword può essere una stringa vuota se il chiamante è connesso usando lo stesso nome di dominio e il nome utente dell'ID di accesso. Il valore di pPassword non può essere NULL.

[in] bWait

Indica se l'operazione è sincrona. Specificare TRUE per attendere il completamento dell'operazione oppure FALSE per restituire immediatamente.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è un valore diverso da zero.

Se la funzione ha esito negativo, il valore restituito è zero. Per informazioni dettagliate sull'errore, chiamare GetLastError.

Commenti

Il parametro LogonId o TargetLogonId può essere LOGONID_CURRENT, ma non entrambi.

Nota

L'intestazione wtsapi32.h definisce WTSConnectSession 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 che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.

Requisiti


Client minimo supportato	Windows Vista con SP1
Server minimo supportato	Windows Server 2008
Piattaforma di destinazione	Windows
Intestazione	wtsapi32.h
Libreria	Wtsapi32.lib
DLL	Wtsapi32.dll

Condividi tramite