LsaSetTrustedDomainInformation-Funktion (ntsecapi.h)
Die LsaSetTrustedDomainInformation-Funktion ändert die Informationen eines Policy-Objekts zu einer vertrauenswürdigen Domäne.
Syntax
NTSTATUS LsaSetTrustedDomainInformation(
[in] LSA_HANDLE PolicyHandle,
[in] PSID TrustedDomainSid,
[in] TRUSTED_INFORMATION_CLASS InformationClass,
[in] PVOID Buffer
);
Parameter
[in] PolicyHandle
Ein Handle für das Policy-Objekt eines Domänencontrollers. Die erforderlichen Benutzerrechte für dieses Handle hängen vom Wert des InformationClass-Parameters ab . Weitere Informationen finden Sie unter Öffnen eines Richtlinienobjekthandles.
[in] TrustedDomainSid
Zeiger auf die SID der vertrauenswürdigen Domäne, deren Informationen geändert werden. Wenn der Parameter InformationClass auf TrustedDomainNameInformation festgelegt ist, muss dieser Parameter auf die SID der Domäne verweisen, die der Liste der vertrauenswürdigen Domänen hinzugefügt werden soll.
[in] InformationClass
Gibt einen der folgenden Werte aus dem TRUSTED_INFORMATION_CLASS-Enumerationstyp an. Der Wert gibt den Typ der festzulegenden Informationen an.
| Wert | Bedeutung |
|---|---|
|
Wenn die angegebene Domäne nicht in der Liste der vertrauenswürdigen Domänen enthalten ist, wird sie von der LsaSetTrustedDomainInformation-Funktion hinzugefügt. Der TrustedDomainSid-Parameter muss die SID der hinzuzufügenden Domäne sein. Der Parameter Buffer muss ein Zeiger auf eine TRUSTED_DOMAIN_NAME_INFO Struktur sein, die den Namen der hinzuzufügenden Domäne enthält.
Wenn die angegebene Domäne bereits in der Liste der vertrauenswürdigen Domänen enthalten ist, schlägt die Funktion fehl. |
|
Legt den Wert fest, der zum Generieren von Posix-Benutzer- und Gruppenbezeichnern verwendet wird. Der Buffer-Parameter muss ein Zeiger auf eine TRUSTED_POSIX_OFFSET_INFO-Struktur sein. |
|
Legt das Kennwort für die vertrauenswürdige Domäne fest. Der Parameter Buffer muss ein Zeiger auf eine TRUSTED_PASSWORD_INFO-Struktur sein, die die alten und neuen Kennwörter für die angegebene Domäne enthält. Das im Parameter PolicyHandle übergebene Handle muss über das zugriffsrecht POLICY_CREATE_SECRET verfügen. Die alte Kennwortzeichenfolge kann NULL sein. |
[in] Buffer
Zeiger auf eine Struktur, die die festzulegenden Informationen enthält. Der Typ der Struktur hängt vom Wert des InformationClass-Parameters ab.
Rückgabewert
Wenn die Funktion erfolgreich ist, wird der Rückgabewert STATUS_SUCCESS.
Wenn die Funktion fehlschlägt, ist der Rückgabewert ein NTSTATUS-Code. Weitere Informationen finden Sie unter Rückgabewerte der LSA-Richtlinienfunktion.
Sie können die LsaNtStatusToWinError-Funktion verwenden, um den NTSTATUS-Code in einen Windows-Fehlercode zu konvertieren.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows XP [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2003 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | ntsecapi.h |
| Bibliothek | Advapi32.lib |
| DLL | Advapi32.dll |