LsaSetInformationPolicy-Funktion (ntsecapi.h)
Die LsaSetInformationPolicy-Funktion ändert Informationen in einem Policy-Objekt .
Syntax
NTSTATUS LsaSetInformationPolicy(
[in] LSA_HANDLE PolicyHandle,
[in] POLICY_INFORMATION_CLASS InformationClass,
[in] PVOID Buffer
);
Parameter
[in] PolicyHandle
Ein Handle für ein Policy-Objekt . Die erforderlichen Zugriffsrechte für dieses Handle hängen vom Wert des Parameters InformationClass ab. Weitere Informationen finden Sie unter Öffnen eines Richtlinienobjekthandles.
[in] InformationClass
Gibt einen der folgenden Werte aus dem POLICY_INFORMATION_CLASS Enumerationstyp an. Der Wert gibt den Typ der festzulegenden Informationen an.
| Wert | Bedeutung |
|---|---|
|
Legt die Überwachungsregeln des Systems fest. Das im PolicyHandle-Parameter übergebene Handle muss über das zugriffsrecht POLICY_SET_AUDIT_REQUIREMENTS verfügen. Der Buffer-Parameter muss ein Zeiger auf eine POLICY_AUDIT_EVENTS_INFO Struktur sein. |
|
Legt den Namen und die SID der primären Domäne des Systems fest. Das im PolicyHandle-Parameter übergebene Handle muss über das zugriffsrecht POLICY_TRUST_ADMIN verfügen. Der Buffer-Parameter muss ein Zeiger auf eine POLICY_PRIMARY_DOMAIN_INFO-Struktur sein. |
|
Legt den Namen und die SID der Kontodomäne des Systems fest. Das im PolicyHandle-Parameter übergebene Handle muss über das zugriffsrecht POLICY_TRUST_ADMIN verfügen. Der Buffer-Parameter muss ein Zeiger auf eine POLICY_ACCOUNT_DOMAIN_INFO Struktur sein. |
|
Legt DNS-Informationen (Domain Name System) zur primären Domäne fest, die dem Policy-Objekt zugeordnet ist. Das im PolicyHandle-Parameter übergebene Handle muss über das zugriffsrecht POLICY_TRUST_ADMIN verfügen. Der Buffer-Parameter muss ein Zeiger auf eine POLICY_DNS_DOMAIN_INFO-Struktur sein. |
|
Legt die Rolle eines LSA-Servers fest. Das im PolicyHandle-Parameter übergebene Handle muss über das zugriffsrecht POLICY_SERVER_ADMIN verfügen. Der Buffer-Parameter muss ein Zeiger auf eine POLICY_LSA_SERVER_ROLE_INFO Struktur sein.
Das Ändern der Rolle eines Servers von der primären auf die Sicherung hat keine Auswirkungen (obwohl die Funktion STATUS_SUCCESS zurückgibt). Das Ändern der Rolle eines Servers von der Sicherung in die primäre Rolle erfordert umfangreiche Netzwerkvorgänge und ist möglicherweise langsam. |
[in] Buffer
Zeiger auf eine Struktur, die die festzulegenden Informationen enthält. Der Typ der Struktur hängt vom Wert des Parameters InformationClass 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 |