Funzione LsaSetForestTrustInformation (ntsecapi.h)

  • Articolo

La funzione LsaSetForestTrustTrustInformation imposta le informazioni di trust tra foreste per un oggetto TrustedDomaindell'autorità di sicurezza locale specificato.

Sintassi

NTSTATUS LsaSetForestTrustInformation(
  [in]  LSA_HANDLE                              PolicyHandle,
  [in]  PLSA_UNICODE_STRING                     TrustedDomainName,
  [in]  PLSA_FOREST_TRUST_INFORMATION           ForestTrustInfo,
  [in]  BOOLEAN                                 CheckOnly,
  [out] PLSA_FOREST_TRUST_COLLISION_INFORMATION *CollisionInfo
);

Parametri

[in] PolicyHandle

Handle per l'oggetto Policy per il sistema.

[in] TrustedDomainName

Puntatore a una struttura LSA_UNICODE_STRING che contiene il nome dell'oggetto TrustedDomain su cui impostare le informazioni di trust tra foreste specificate dal parametro ForestTrustInfo .

[in] ForestTrustInfo

Puntatore a una struttura LSA_FOREST_TRUST_INFORMATION contenente le informazioni di trust tra foreste da impostare sull'oggetto TrustedDomain specificato dal parametro TrustedDomainName .

[in] CheckOnly

Valore booleano che specifica se le modifiche apportate all'oggetto TrustedDomain vengono mantenute. Se questo valore è TRUE, questa funzione verificherà la presenza di conflitti con i parametri specificati, ma non imposterà le informazioni di trust tra foreste specificate dal parametro ForestTrustInfo sull'oggetto TrustedDomain specificato dal parametro TrustedDomainName. Se questo valore è FALSE, le informazioni sul trust tra foreste verranno impostate sull'oggetto TrustedDomain .

[out] CollisionInfo

Puntatore a un puntatore a una struttura LSA_FOREST_TRUST_COLLISION_INFORMATION che restituisce informazioni su eventuali conflitti che si sono verificati.

Valore restituito

Se la funzione ha esito positivo, il valore restituito viene STATUS_SUCCESS.

Se la funzione ha esito negativo, il valore restituito è un codice NTSTATUS, che può essere uno dei valori seguenti o uno dei valori restituiti della funzione criteri LSA.

Codice/valore restituito Descrizione
STATUS_INVALID_DOMAIN_STATE
 L'operazione è legale solo nei controller di dominio nel dominio radice.
STATUS_INVALID_DOMAIN_ROLE
 L'operazione è legale solo nel controller di dominio primario.

Requisiti

Requisito Valore
Client minimo supportato Nessuno supportato
Server minimo supportato Windows Server 2003 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione ntsecapi.h
Libreria Advapi32.lib
DLL Advapi32.dll