Funzione WTSConnectSessionW (wtsapi32.h)

Articolo
11/20/2024

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

Sintassi

BOOL WTSConnectSessionW(
  [in] ULONG LogonId,
  [in] ULONG TargetLogonId,
  [in] PWSTR 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 identificata 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 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 ottenere informazioni estese sull'errore, chiamare GetLastError.

Osservazioni

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 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 Vista con SP1
server minimo supportato	Windows Server 2008
piattaforma di destinazione	Finestre
intestazione	wtsapi32.h
libreria	Wtsapi32.lib
dll	Wtsapi32.dll

Condividi tramite