Función LsaSetInformationPolicy (ntsecapi.h)

  • Artículo

La función LsaSetInformationPolicy modifica la información de un objeto Policy .

Sintaxis

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

Parámetros

[in] PolicyHandle

Identificador de un objeto Policy . Los derechos de acceso necesarios para este identificador dependen del valor del parámetro InformationClass . Para obtener más información, vea Apertura de un identificador de objeto de directiva.

[in] InformationClass

Especifica uno de los siguientes valores del tipo de enumeración POLICY_INFORMATION_CLASS . El valor indica el tipo de información que se va a establecer.

Valor Significado
PolicyAuditEventsInformation
 Establece las reglas de auditoría del sistema. El identificador pasado en el parámetro PolicyHandle debe tener el derecho de acceso POLICY_SET_AUDIT_REQUIREMENTS. El parámetro Buffer debe ser un puntero a una estructura POLICY_AUDIT_EVENTS_INFO .
PolicyPrimaryDomainInformation
 Establece el nombre y el SID del dominio principal del sistema. El identificador pasado en el parámetro PolicyHandle debe tener el derecho de acceso POLICY_TRUST_ADMIN. El parámetro Buffer debe ser un puntero a una estructura de POLICY_PRIMARY_DOMAIN_INFO .
PolicyAccountDomainInformation
 Establece el nombre y el SID del dominio de cuenta del sistema. El identificador pasado en el parámetro PolicyHandle debe tener el derecho de acceso POLICY_TRUST_ADMIN. El parámetro Buffer debe ser un puntero a una estructura de POLICY_ACCOUNT_DOMAIN_INFO .
PolicyDnsDomainInformation
 Establece información del sistema de nombres de dominio (DNS) sobre el dominio principal asociado al objeto Policy . El identificador pasado en el parámetro PolicyHandle debe tener el derecho de acceso POLICY_TRUST_ADMIN. El parámetro Buffer debe ser un puntero a una estructura de POLICY_DNS_DOMAIN_INFO .
PolicyLsaServerRoleInformation
 Establece el rol de un servidor LSA. El identificador pasado en el parámetro PolicyHandle debe tener el derecho de acceso POLICY_SERVER_ADMIN. El parámetro Buffer debe ser un puntero a una estructura de POLICY_LSA_SERVER_ROLE_INFO .

Cambiar el rol de un servidor de principal a copia de seguridad no tiene ningún efecto (aunque la función devuelve STATUS_SUCCESS). Cambiar el rol de un servidor de copia de seguridad a principal requiere operaciones de red extensas y puede ser lenta.

[in] Buffer

Puntero a una estructura que contiene la información que se va a establecer. El tipo de estructura depende del valor del parámetro InformationClass .

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es STATUS_SUCCESS.

Si se produce un error en la función, el valor devuelto es un código NTSTATUS. Para obtener más información, vea Valores devueltos de la función de directiva LSA.

Puede usar la función LsaNtStatusToWinError para convertir el código NTSTATUS en un código de error de Windows.

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado ntsecapi.h
Library Advapi32.lib
Archivo DLL Advapi32.dll

Consulte también

POLICY_ACCOUNT_DOMAIN_INFO

POLICY_AUDIT_EVENTS_INFO

POLICY_DNS_DOMAIN_INFO

POLICY_LSA_SERVER_ROLE_INFO

POLICY_PRIMARY_DOMAIN_INFO