Compartir a través de


Función LsaQueryInformationPolicy (ntsecapi.h)

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

Consulte también

LsaFreeMemory

LsaSetInformationPolicy

POLICY_ACCOUNT_DOMAIN_INFO

POLICY_AUDIT_EVENTS_INFO

POLICY_DNS_DOMAIN_INFO

POLICY_INFORMATION_CLASS

POLICY_LSA_SERVER_ROLE_INFO

POLICY_MODIFICATION_INFO

POLICY_PRIMARY_DOMAIN_INFO