Funzione LsaSetTrustedDomainInformation (ntsecapi.h)
La funzione LsaSetTrustedDomainInformation modifica le informazioni di un oggetto Policy su un dominio attendibile.
Sintassi
NTSTATUS LsaSetTrustedDomainInformation(
[in] LSA_HANDLE PolicyHandle,
[in] PSID TrustedDomainSid,
[in] TRUSTED_INFORMATION_CLASS InformationClass,
[in] PVOID Buffer
);
Parametri
[in] PolicyHandle
Handle per l'oggetto Policy di un controller di dominio. I diritti utente necessari per questo handle dipendono dal valore del parametro InformationClass . Per altre informazioni, vedere Apertura di un handle oggetto Criteri.
[in] TrustedDomainSid
Puntatore al SID del dominio attendibile le cui informazioni vengono modificate. Se il parametro InformationClass è impostato su TrustedDomainNameInformation, questo parametro deve puntare al SID del dominio per aggiungere all'elenco di domini attendibili.
[in] InformationClass
Specifica uno dei valori seguenti dal tipo di enumerazione TRUSTED_INFORMATION_CLASS . Il valore indica il tipo di informazioni impostate.
| Valore | Significato |
|---|---|
|
Se il dominio specificato non è incluso nell'elenco di domini attendibili, la funzione LsaSetTrustedDomainInformation lo aggiunge. Il parametro TrustedDomainSid deve essere il SID del dominio da aggiungere. Il parametro Buffer deve essere un puntatore a una struttura TRUSTED_DOMAIN_NAME_INFO contenente il nome del dominio da aggiungere.
Se il dominio specificato è già incluso nell'elenco di domini attendibili, la funzione ha esito negativo. |
|
Imposta il valore usato per generare identificatori di utente e gruppo Posix. Il parametro Buffer deve essere un puntatore a una struttura TRUSTED_POSIX_OFFSET_INFO . |
|
Imposta la password per il dominio attendibile. Il parametro Buffer deve essere un puntatore a una struttura TRUSTED_PASSWORD_INFO contenente le password precedenti e nuove per il dominio specificato. L'handle passato nel parametro PolicyHandle deve avere il diritto di accesso POLICY_CREATE_SECRET. La stringa di password precedente può essere NULL. |
[in] Buffer
Puntatore a una struttura contenente le informazioni da impostare. Il tipo di struttura dipende dal valore del parametro InformationClass .
Valore restituito
Se la funzione ha esito positivo, il valore restituito è STATUS_SUCCESS.
Se la funzione ha esito negativo, il valore restituito è un codice NTSTATUS. Per altre informazioni, vedere Valori restituiti dalla funzione criteri LSA.
È possibile usare la funzione LsaNtStatusToWinError per convertire il codice NTSTATUS in un codice di errore di Windows.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows XP [solo app desktop] |
| Server minimo supportato | Windows Server 2003 [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | ntsecapi.h |
| Libreria | Advapi32.lib |
| DLL | Advapi32.dll |