RsopSetPolicySettingStatus function (userenv.h)

Article
02/22/2024

The RSoPSetPolicySettingStatus function creates an instance of RSOP_PolicySettingStatus and an instance of RSOP_PolicySettingLink. The function links (associates) RSOP_PolicySettingStatus to its RSOP_PolicySetting instance.

Syntax

USERENVAPI HRESULT RsopSetPolicySettingStatus(
  [in] DWORD                   dwFlags,
  [in] IWbemServices           *pServices,
  [in] IWbemClassObject        *pSettingInstance,
  [in] DWORD                   nInfo,
  [in] POLICYSETTINGSTATUSINFO *pStatus
);

Parameters

[in] dwFlags

This parameter is currently unused.

[in] pServices

Specifies a WMI services pointer to the RSoP namespace to which the policy data is to be written. This parameter is required.

[in] pSettingInstance

Pointer to an instance of RSOP_PolicySetting containing the policy setting. This parameter is required and can point to the instance's children.

[in] nInfo

Specifies the number of elements in the pStatus array.

[in] pStatus

Pointer to an array of POLICYSETTINGSTATUSINFO structures.

Return value

If the function succeeds, the return value is S_OK. Otherwise, the function returns one of the COM error codes defined in the Platform SDK header file WinError.h.

Remarks

To unlink an RSOP_PolicySettingStatus instance from its RSOP_PolicySetting instance, you can call the RSoPResetPolicySettingStatus function.

Requirements

Requirement	Value
Minimum supported client	Windows Vista
Minimum supported server	Windows Server 2008
Target Platform	Windows
Header	userenv.h
Library	Userenv.lib
DLL	Userenv.dll