Función LsaOpenPolicy (ntsecapi.h)

  • Artículo

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

Consulte también

LSA_HANDLE

LSA_OBJECT_ATTRIBUTES

LSA_UNICODE_STRING

LsaClose

LsaNtStatusToWinError