SetProtectedPolicy function

Sets a protected policy. This function is for use primarily by Windows, and not designed for external use.

Syntax

BOOL SetProtectedPolicy(
  LPCGUID    PolicyGuid,
  ULONG_PTR  PolicyValue,
  PULONG_PTR OldPolicyValue
);

Parameters

PolicyGuid

The globally-unique identifier of the policy to set.

PolicyValue

The value to set the policy to.

OldPolicyValue

Optionally receives the original value that was associated with the supplied policy.

Return Value

True if the function succeeds; otherwise, false. To retrieve error values for this function, call GetLastError.

Remarks

Protected policies are process-wide configuration settings that are stored in read-only memory. This is intended to help protect the policy from being corrupted or altered in an unintended way while an application is executing. Protected policies are primarily a construct internal to Windows.

To compile an application that calls this function, define _WIN32_WINNT as 0x0603 or later. For more information, see Using the Windows Headers.

This function became available in update 3 (the November 2014 update) for Windows 8.1 and Windows Server 2012 R2.

Requirements

   
Minimum supported client Windows 8.1 [desktop apps only]
Minimum supported server Windows Server 2012 R2 [desktop apps only]
Target Platform Windows
Header processthreadsapi.h (include Windows.h)
Library Kernel32.lib
DLL Kernel32.dll