Funzione LsaSetTrustedDomainInformation (ntsecapi.h)

  • Articolo

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
TrustedDomainNameInformation
 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.
TrustedPosixOffsetInformation
 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 .
TrustedPasswordInformation
 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

Vedi anche

LsaDeleteTrustedDomain

LsaQueryTrustedDomainInfo

TRUSTED_DOMAIN_NAME_INFO

TRUSTED_INFORMATION_CLASS

TRUSTED_PASSWORD_INFO

TRUSTED_POSIX_OFFSET_INFO