Compartilhar via

Função SetProtectedPolicy (processthreadsapi.h)

  • Artigo

Define uma política protegida. Essa função é usada principalmente pelo Windows e não foi projetada para uso externo.

Sintaxe

BOOL SetProtectedPolicy(
  [in]  LPCGUID    PolicyGuid,
  [in]  ULONG_PTR  PolicyValue,
  [out] PULONG_PTR OldPolicyValue
);

Parâmetros

[in] PolicyGuid

O identificador global exclusivo da política a ser definida.

[in] PolicyValue

O valor para o qual definir a política.

[out] OldPolicyValue

Opcionalmente, recebe o valor original que foi associado à política fornecida.

Retornar valor

True se a função for bem-sucedida; caso contrário, false. Para recuperar valores de erro para essa função, chame GetLastError.

Comentários

As políticas protegidas são definições de configuração em todo o processo armazenadas na memória somente leitura. Isso se destina a ajudar a proteger a política de ser corrompida ou alterada de maneira não intencional enquanto um aplicativo está em execução. As políticas protegidas são principalmente um constructo interno para o Windows.

Para compilar um aplicativo que chama essa função, defina _WIN32_WINNT como 0x0603 ou posterior. Para obter mais informações, consulte Usando os cabeçalhos do Windows.

Essa função ficou disponível na atualização 3 (atualização de novembro de 2014) para Windows 8.1 e Windows Server 2012 R2.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 8.1 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2012 R2 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho processthreadsapi.h (inclua Windows.h)
Biblioteca Kernel32.lib
DLL Kernel32.dll