SetProtectedPolicy function (processthreadsapi.h)

Article
02/22/2024

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

Syntax

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

Parameters

[in] PolicyGuid

The globally-unique identifier of the policy to set.

[in] PolicyValue

The value to set the policy to.

[out] 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

Requirement	Value
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

Share via