Funzione LsaSetInformationPolicy (ntsecapi.h)

  • Articolo

La funzione LsaSetInformationPolicy modifica le informazioni in un oggetto Policy .

Sintassi

NTSTATUS LsaSetInformationPolicy(
  [in] LSA_HANDLE               PolicyHandle,
  [in] POLICY_INFORMATION_CLASS InformationClass,
  [in] PVOID                    Buffer
);

Parametri

[in] PolicyHandle

Handle a un oggetto Policy . I diritti di accesso necessari per questo handle dipendono dal valore del parametro InformationClass . Per altre informazioni, vedere Apertura di un handle oggetto Criteri.

[in] InformationClass

Specifica uno dei valori seguenti dal tipo di enumerazione POLICY_INFORMATION_CLASS . Il valore indica il tipo di informazioni da impostare.

Valore Significato
PolicyAuditEventsInformation
 Imposta le regole di controllo del sistema. L'handle passato nel parametro PolicyHandle deve avere il diritto di accesso POLICY_SET_AUDIT_REQUIREMENTS. Il parametro Buffer deve essere un puntatore a una struttura POLICY_AUDIT_EVENTS_INFO .
PolicyPrimaryDomainInformation
 Imposta il nome e il SID del dominio primario del sistema. L'handle passato nel parametro PolicyHandle deve avere il diritto di accesso POLICY_TRUST_ADMIN. Il parametro Buffer deve essere un puntatore a una struttura POLICY_PRIMARY_DOMAIN_INFO .
PolicyAccountDomainInformation
 Imposta il nome e il SID del dominio account del sistema. L'handle passato nel parametro PolicyHandle deve avere il diritto di accesso POLICY_TRUST_ADMIN. Il parametro Buffer deve essere un puntatore a una struttura POLICY_ACCOUNT_DOMAIN_INFO .
PolicyDnsDomainInformation
 Imposta le informazioni dns (Domain Name System) relative al dominio primario associato all'oggetto Policy . L'handle passato nel parametro PolicyHandle deve avere il diritto di accesso POLICY_TRUST_ADMIN. Il parametro Buffer deve essere un puntatore a una struttura POLICY_DNS_DOMAIN_INFO .
PolicyLsaServerRoleInformation
 Imposta il ruolo di un server LSA. L'handle passato nel parametro PolicyHandle deve avere il diritto di accesso POLICY_SERVER_ADMIN. Il parametro Buffer deve essere un puntatore a una struttura POLICY_LSA_SERVER_ROLE_INFO .

La modifica del ruolo di un server da primaria a backup non ha alcun effetto (anche se la funzione restituisce STATUS_SUCCESS). La modifica del ruolo di un server dal backup al primario richiede operazioni di rete estese e potrebbe essere lenta.

[in] Buffer

Puntatore a una struttura contenente le informazioni da impostare. Il tipo di struttura dipende dal valore del parametro InformationClass .

Valore restituito

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

Se la funzione ha esito negativo, il valore restituito è un codice NTSTATUS. Per altre informazioni, vedere Valori restituiti dalla funzione criteri LSA.

È possibile usare la funzione LsaNtStatusToWinError per convertire il codice NTSTATUS in un codice di errore di Windows.

Requisiti

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

Vedi anche

POLICY_ACCOUNT_DOMAIN_INFO

POLICY_AUDIT_EVENTS_INFO

POLICY_DNS_DOMAIN_INFO

POLICY_LSA_SERVER_ROLE_INFO

POLICY_PRIMARY_DOMAIN_INFO