Función SaferGetPolicyInformation (winsafer.h)

La función SaferGetPolicyInformation obtiene información sobre una directiva. Puede consultar para obtener más información sobre la directiva.

Sintaxis

BOOL SaferGetPolicyInformation(
  [in]  DWORD                   dwScopeId,
  [in]  SAFER_POLICY_INFO_CLASS SaferPolicyInfoClass,
  [in]  DWORD                   InfoBufferSize,
  [out] PVOID                   InfoBuffer,
  [out] PDWORD                  InfoBufferRetSize,
        LPVOID                  lpReserved
);

Parámetros

[in] dwScopeId

Ámbito de la consulta. En la siguiente tabla se muestran los valores posibles.

Valor	Significado
SAFER_SCOPEID_MACHINE 1	El ámbito de la consulta es por equipo.
SAFER_SCOPEID_USER 2	El ámbito de la consulta es por el usuario.

[in] SaferPolicyInfoClass

Valor de enumeración SAFER_POLICY_INFO_CLASS que especifica el tipo de información de directiva que se debe devolver. El valor especificado determina el tamaño y el tipo del parámetro InfoBuffer . En la siguiente tabla se muestran los valores posibles.

Valor	Significado
SaferPolicyLevelList 1	Consulta la lista de todos los niveles definidos en una directiva. Tipo de valor devuelto infoBuffer: matriz DWORD de LevelIds.
SaferPolicyEnableTransparentEnforcement 2	Consulta el valor de la directiva para determinar si la comprobación de DLL está habilitada. Tipo de valor devuelto infoBuffer: booleano DWORD.
SaferPolicyDefaultLevel 3	Consulta para el nivel de directiva predeterminado. Tipo de valor devuelto infoBuffer: DWORD LevelId.
SaferPolicyEvaluateUserScope 4	Consultas para determinar si se deben consultar las reglas de ámbito de usuario durante la evaluación de directivas. Tipo de valor devuelto infoBuffer: DWORD.
SaferPolicyScopeFlags 5	Consulta para determinar si la directiva va a omitir los miembros del grupo de administradores locales. Tipo de valor devuelto infoBuffer: DWORD.

[in] InfoBufferSize

Tamaño, en bytes, del parámetro InfoBuffer .

[out] InfoBuffer

Búfer que contiene los resultados de la consulta. El tamaño y el tipo de la información devuelta viene determinado por el parámetro SaferPolicyInfoClass . Para obtener el tipo de información devuelta para cada valor posible del parámetro SaferPolicyInfoClass , vea el parámetro SaferPolicyInfoClass .

[out] InfoBufferRetSize

Número de bytes del parámetro InfoBuffer que se rellenaron con información de directiva.

lpReserved

Reservado para uso futuro. Este parámetro debe establecerse en NULL.

Valor devuelto

TRUE si la función se realiza correctamente; de lo contrario, FALSE. Para obtener información de error extendida, llame a GetLastError.

Requisitos

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	winsafer.h
Library	Advapi32.lib
Archivo DLL	Advapi32.dll
Conjunto de API	ext-ms-win-advapi32-safer-l1-1-0 (introducido en Windows 8)