Função SaferGetPolicyInformation (winsafer.h)

A função SaferGetPolicyInformation obtém informações sobre uma política. Você pode consultar para saber mais informações sobre a política.

Sintaxe

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

O escopo da consulta. A tabela a seguir mostra os valores possíveis.

Valor	Significado
SAFER_SCOPEID_MACHINE 1	O escopo da consulta é por computador.
SAFER_SCOPEID_USER 2	O escopo da consulta é por usuário.

[in] SaferPolicyInfoClass

Um SAFER_POLICY_INFO_CLASS valor de enumeração que especifica o tipo de informações de política que devem ser retornadas. O valor especificado determina o tamanho e o tipo do parâmetro InfoBuffer . A tabela a seguir mostra os valores possíveis.

Valor	Significado
SaferPolicyLevelList 1	Consultas para a lista de todos os níveis definidos em uma política. Tipo de retorno do InfoBuffer : matriz DWORD de LevelIds.
SaferPolicyEnableTransparentEnforcement 2	Consulta o valor da política para determinar se a verificação de DLL está habilitada. Tipo de retorno do InfoBuffer : DWORD Boolean.
SaferPolicyDefaultLevel 3	Consultas para o nível de política padrão. Tipo de retorno do InfoBuffer : DWORD LevelId.
SaferPolicyEvaluateUserScope 4	Consultas para determinar se as regras de escopo do usuário devem ser consultadas durante a avaliação da política. Tipo de retorno do InfoBuffer : DWORD.
SaferPolicyScopeFlags 5	Consultas para determinar se a política deve ignorar membros do grupo de administradores locais. Tipo de retorno do InfoBuffer : DWORD.

[in] InfoBufferSize

O tamanho, em bytes, do parâmetro InfoBuffer .

[out] InfoBuffer

Um buffer para conter os resultados da consulta. O tamanho e o tipo das informações retornadas são determinados pelo parâmetro SaferPolicyInfoClass . Para obter o tipo das informações retornadas para cada valor possível do parâmetro SaferPolicyInfoClass , consulte o parâmetro SaferPolicyInfoClass .

[out] InfoBufferRetSize

O número de bytes no parâmetro InfoBuffer que foram preenchidos com informações de política.

lpReserved

Reservado para uso futuro. Esse parâmetro deve ser definido como NULL.

Valor retornado

TRUE se a função for bem-sucedida; caso contrário, FALSE. Para obter informações de erro estendidas, chame GetLastError.

Requisitos

Cliente mínimo com suporte	Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	winsafer.h
Biblioteca	Advapi32.lib
DLL	Advapi32.dll
Conjunto de APIs	ext-ms-win-advapi32-safer-l1-1-0 (introduzido no Windows 8)