Função SaferGetPolicyInformation (winsafer.h)

  • Artigo

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)