Función LsaSetInformationPolicy (ntsecapi.h)
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 |
|---|---|
|
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 . |
|
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 . |
|
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 . |
|
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 . |
|
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 |