Função SaferSetPolicyInformation (winsafer.h)

  • Artigo

A função SaferSetPolicyInformation define os controles de política global.

Sintaxe

BOOL SaferSetPolicyInformation(
  [in] DWORD                   dwScopeId,
  [in] SAFER_POLICY_INFO_CLASS SaferPolicyInfoClass,
  [in] DWORD                   InfoBufferSize,
  [in] PVOID                   InfoBuffer,
       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 definidas. 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
 Define a lista de todos os níveis definidos em uma política.

Tipo de retorno do InfoBuffer : matriz DWORD de LevelIds.
SaferPolicyEnableTransparentEnforcement
2
 Define o valor da política para determinar se a verificação de DLL está habilitada.

Tipo de retorno do InfoBuffer : DWORD booleano.
SaferPolicyDefaultLevel
3
 Define o nível de política padrão.

Tipo de retorno do InfoBuffer : DWORD LevelId.
SaferPolicyEvaluateUserScope
4
 Define 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
 Define 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 .

[in] 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 .

lpReserved

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

Retornar valor

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

Requisitos

Requisito Valor
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)