LsaSetInformationPolicy-Funktion (ntsecapi.h)

  • Artikel

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
PolicyAuditEventsInformation
 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.
PolicyPrimaryDomainInformation
 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.
PolicyAccountDomainInformation
 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.
PolicyDnsDomainInformation
 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.
PolicyLsaServerRoleInformation
 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

Weitere Informationen

POLICY_ACCOUNT_DOMAIN_INFO

POLICY_AUDIT_EVENTS_INFO

POLICY_DNS_DOMAIN_INFO

POLICY_LSA_SERVER_ROLE_INFO

POLICY_PRIMARY_DOMAIN_INFO