QueryProtectedPolicy function (processthreadsapi.h)

Article
02/22/2024

Queries the value associated with a protected policy.

Syntax

BOOL QueryProtectedPolicy(
  [in]  LPCGUID    PolicyGuid,
  [out] PULONG_PTR PolicyValue
);

Parameters

[in] PolicyGuid

The globally-unique identifier of the policy to query.

[out] PolicyValue

Receives the value that the supplied policy is set to.

Return value

True if the function succeeds; otherwise, false.

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.

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 Windows 8.1 and Windows Server 2012 R2 update 3 (the November 2014 update).

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