Función LsaOpenPolicy (ntsecapi.h)
La función LsaOpenPolicy abre un identificador para el objeto Policy en un sistema local o remoto.
Debe ejecutar el proceso "Como administrador" para que no se produzca un error en la llamada a ERROR_ACCESS_DENIED.
Sintaxis
NTSTATUS LsaOpenPolicy(
[in] PLSA_UNICODE_STRING SystemName,
[in] PLSA_OBJECT_ATTRIBUTES ObjectAttributes,
[in] ACCESS_MASK DesiredAccess,
[in, out] PLSA_HANDLE PolicyHandle
);
Parámetros
[in] SystemName
Puntero a una estructura LSA_UNICODE_STRING que contiene el nombre del sistema de destino. El nombre puede tener el formato "NombreDeEquipo" o "\\NombreDeEquipo". Si este parámetro es NULL, la función abre el objeto Policy en el sistema local.
[in] ObjectAttributes
Puntero a una estructura LSA_OBJECT_ATTRIBUTES que especifica los atributos de conexión. No se utilizan los miembros de la estructura; inicialícelos en NULL o cero.
[in] DesiredAccess
Un ACCESS_MASK que especifica los derechos de acceso solicitados. Se produce un error en la función si la DACL del sistema de destino no permite al autor de la llamada el acceso solicitado. Para determinar los derechos de acceso que necesita, consulte la documentación de las funciones de LSA con las que desea usar el identificador de directiva.
[in, out] PolicyHandle
Puntero a una variable LSA_HANDLE que recibe un identificador para el objeto Policy .
Cuando ya no necesite este identificador, páselo a la función LsaClose para cerrarlo.
Valor devuelto
Si la función se realiza correctamente, la función devuelve STATUS_SUCCESS.
Si se produce un error en la función, devuelve 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.
Comentarios
Para administrar la directiva de seguridad local de un sistema local o remoto, debe llamar a la función LsaOpenPolicy para establecer una sesión con el subsistema LSA del sistema. LsaOpenPolicy se conecta al LSA del sistema de destino y devuelve un identificador al objeto Policy de ese sistema. Puede usar este identificador en llamadas de función LSA posteriores para administrar la información de la directiva de seguridad local del sistema de destino.
Para obtener un ejemplo en el que se muestra cómo llamar a esta función, consulte Apertura de un identificador de objeto de directiva.
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 |