Partager via


LsaSetForestTrustInformation, fonction (ntsecapi.h)

La fonction LsaSetForestTrustInformation définit les informations d’approbation de forêt pour un objet TrustedDomain de l’autorité de sécurité locale spécifiée.

Syntaxe

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
);

Paramètres

[in] PolicyHandle

Handle de l’objet De stratégie pour le système.

[in] TrustedDomainName

Pointeur vers une structure LSA_UNICODE_STRING qui contient le nom de l’objet TrustedDomain sur lequel définir les informations d’approbation de forêt spécifiées par le paramètre ForestTrustInfo .

[in] ForestTrustInfo

Pointeur vers une structure LSA_FOREST_TRUST_INFORMATION qui contient les informations d’approbation de forêt à définir sur l’objet TrustedDomain spécifié par le paramètre TrustedDomainName .

[in] CheckOnly

Valeur booléenne qui spécifie si les modifications apportées à l’objet TrustedDomain sont conservées. Si cette valeur est TRUE, cette fonction vérifie les collisions avec les paramètres spécifiés, mais ne définit pas les informations d’approbation de forêt spécifiées par le paramètre ForestTrustInfo sur l’objet TrustedDomain spécifié par le paramètre TrustedDomainName. Si cette valeur est FALSE, les informations d’approbation de forêt sont définies sur l’objet TrustedDomain .

[out] CollisionInfo

Pointeur vers un pointeur vers une structure LSA_FOREST_TRUST_COLLISION_INFORMATION qui retourne des informations sur les collisions qui se sont produites.

Valeur retournée

Si la fonction réussit, la valeur de retour est STATUS_SUCCESS.

Si la fonction échoue, la valeur de retour est un code NTSTATUS, qui peut être l’une des valeurs suivantes ou l’une des valeurs de retour de la fonction de stratégie LSA.

Retourner le code/la valeur Descriptif
STATUS_INVALID_DOMAIN_STATE
L’opération est légale uniquement sur les contrôleurs de domaine du domaine racine.
STATUS_INVALID_DOMAIN_ROLE
L’opération est légale uniquement sur le contrôleur de domaine principal.

Spécifications

Requirement Valeur
Client minimum requis Aucun pris en charge
Serveur minimal pris en charge Windows Server 2003 [applications de bureau uniquement]
plateforme cible Fenêtres
Header ntsecapi.h
Library Advapi32.lib
DLL Advapi32.dll