Funzione WTSSetUserConfigA (wtsapi32.h)
Modifica le informazioni di configurazione per l'utente specificato nel controller di dominio o nel server Host sessione Desktop remoto (Host sessione Desktop remoto).
Sintassi
BOOL WTSSetUserConfigA(
[in] LPSTR pServerName,
[in] LPSTR pUserName,
[in] WTS_CONFIG_CLASS WTSConfigClass,
[in] LPSTR pBuffer,
[in] DWORD DataLength
);
Parametri
[in] pServerName
Puntatore a una stringa con terminazione Null contenente il nome di un controller di dominio o di un server host sessione Desktop remoto. Specificare WTS_CURRENT_SERVER_NAME per indicare il server Host sessione Desktop remoto in cui è in esecuzione l'applicazione.
[in] pUserName
Puntatore a una stringa con terminazione Null contenente il nome dell'utente la cui configurazione è impostata.
[in] WTSConfigClass
Specifica il tipo di informazioni da impostare per l'utente. Questo parametro può essere uno dei valori del tipo di enumerazione WTS_CONFIG_CLASS . La documentazione per WTS_CONFIG_CLASS descrive il formato dei dati specificati in ppBuffer per ognuno dei tipi di informazioni.
[in] pBuffer
Puntatore ai dati usati per modificare la configurazione dell'utente specificato.
[in] DataLength
Dimensioni, in TCHAR, del buffer pBuffer .
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
Le funzioni WTSQueryUserConfig e WTSSetUserConfig vengono passate un nome del server anziché un handle perché le informazioni sull'account utente si trovano spesso in un controller di dominio. Per impostare le informazioni di configurazione utente, usare il controller di dominio primario. È possibile chiamare la funzione NetGetDCName per ottenere il nome del controller di dominio primario. Per eseguire query sulle informazioni di configurazione utente, è possibile usare la funzione NetGetAnyDCName per ottenere il nome di un controller di dominio primario o di backup.
Qualsiasi controller di dominio può impostare o eseguire query sulle informazioni di configurazione dell'utente. Usare la funzione DsGetDcName per recuperare il nome di un controller di dominio.
Se il valore del parametro WTSConfigClass corrisponde a un valore intero nell'enumerazione WTS_CONFIG_CLASS , definire il valore da impostare come DWORD. Eseguire quindi il cast del valore a un LPWSTR nella chiamata a WTSSetUserConfig, come nell'esempio seguente:
WTSSetUserConfig( strServer.GetBuffer(0),
m_strName.GetBuffer(0),
WTSUserConfigfAllowLogonTerminalServer,
(LPWSTR) &dwEnable,
sizeof(DWORD));
Nota
L'intestazione wtsapi32.h definisce WTSSetUserConfig 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
Requisito | Valore |
---|---|
Client minimo supportato | Windows Vista |
Server minimo supportato | Windows Server 2008 |
Piattaforma di destinazione | Windows |
Intestazione | wtsapi32.h |
Libreria | Wtsapi32.lib |
DLL | Wtsapi32.dll |
Vedi anche
Commenti e suggerimenti
https://aka.ms/ContentUserFeedback.
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedereInvia e visualizza il feedback per