Función LsaQueryInformationPolicy (ntsecapi.h)

Artículo
03/15/2023

La función LsaQueryInformationPolicy recupera información sobre un objeto Policy .

Sintaxis

NTSTATUS LsaQueryInformationPolicy(
  [in]  LSA_HANDLE               PolicyHandle,
  [in]  POLICY_INFORMATION_CLASS InformationClass,
  [out] 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 valores siguientes del tipo de enumeración POLICY_INFORMATION_CLASS . El valor indica el tipo de información que se va a recuperar.

Valor	Significado
PolicyAuditEventsInformation	Recupera las reglas de auditoría del sistema. El identificador pasado en el parámetro PolicyHandle debe tener el derecho de acceso POLICY_VIEW_AUDIT_INFORMATION. El parámetro Buffer recibe un puntero a una estructura de POLICY_AUDIT_EVENTS_INFO .
PolicyPrimaryDomainInformation	Recupera 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_VIEW_LOCAL_INFORMATION. El parámetro Buffer recibe un puntero a una estructura de POLICY_PRIMARY_DOMAIN_INFO .
PolicyAccountDomainInformation	Recupera 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_VIEW_LOCAL_INFORMATION. El parámetro Buffer recibe un puntero a una estructura POLICY_ACCOUNT_DOMAIN_INFO .
PolicyLsaServerRoleInformation	Recupera el rol de un servidor LSA. El identificador pasado en el parámetro PolicyHandle debe tener el derecho de acceso POLICY_VIEW_LOCAL_INFORMATION. El parámetro Buffer recibe un puntero a una estructura de POLICY_LSA_SERVER_ROLE_INFO .
PolicyModificationInformation	Recupera información sobre la hora de creación y la última modificación de la base de datos LSA. El identificador pasado en el parámetro PolicyHandle debe tener el derecho de acceso POLICY_VIEW_LOCAL_INFORMATION. El parámetro Buffer recibe un puntero a una estructura de POLICY_MODIFICATION_INFO .
PolicyDnsDomainInformation	Recupera la 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_VIEW_LOCAL_INFORMATION. El parámetro Buffer recibe un puntero a una estructura POLICY_DNS_DOMAIN_INFO .

[out] Buffer

Puntero a una variable que recibe un puntero a una estructura que contiene la información solicitada. El tipo de estructura depende del valor del parámetro InformationClass .

Cuando ya no necesite la información, pase el puntero devuelto a LsaFreeMemory.

Valor devuelto

Si la función LsaQueryInformationPolicy se realiza correctamente, se STATUS_SUCCESS el valor devuelto.

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.

Comentarios

Para obtener un ejemplo en el que se muestra cómo llamar a esta función, consulte Administración de información de directivas.

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