Funzione WTSQueryUserConfigA (wtsapi32.h)
Recupera le informazioni di configurazione per l'utente specificato nel server host sessione desktop remoto o nel controller di dominio specificato.
Sintassi
BOOL WTSQueryUserConfigA(
[in] LPSTR pServerName,
[in] LPSTR pUserName,
[in] WTS_CONFIG_CLASS WTSConfigClass,
[out] LPSTR *ppBuffer,
[out] DWORD *pBytesReturned
);
Parametri
[in] pServerName
Puntatore a una stringa con terminazione null contenente il nome di un controller di dominio o 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 utente da eseguire per la query. Per recuperare le impostazioni utente predefinite per il server Host sessione Desktop remoto, impostare questo parametro su NULL.
Windows Server 2008 e Windows Vista: L'impostazione di questo parametro su NULL restituisce un errore.
[in] WTSConfigClass
Specifica il tipo di informazioni da recuperare. 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 restituiti in ppBuffer per ognuno dei tipi di informazioni.
[out] ppBuffer
Puntatore a una variabile che riceve un puntatore alle informazioni richieste. Il formato e il contenuto dei dati dipendono dalla classe di informazioni specificata nel parametro WTSConfigClass . Per liberare il buffer restituito, chiamare la funzione WTSFreeMemory .
[out] pBytesReturned
Puntatore a una variabile che riceve le dimensioni, in byte, dei dati restituiti in ppBuffer.
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 utente. Usare la funzione DsGetDcName per recuperare il nome di un controller di dominio.
Nota
L'intestazione wtsapi32.h definisce WTSQueryUserConfig 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
| Client minimo supportato | Windows Vista |
| Server minimo supportato | Windows Server 2008 |
| Piattaforma di destinazione | Windows |
| Intestazione | wtsapi32.h |
| Libreria | Wtsapi32.lib |
| DLL | Wtsapi32.dll |