RsopResetPolicySettingStatus function (userenv.h)

Article
02/22/2024

The RSoPResetPolicySettingStatus function unlinks the RSOP_PolicySettingStatus instance from its RSOP_PolicySetting instance. The function deletes the instances of RSOP_PolicySettingStatus and RSOP_PolicySettingLink. Optionally, you can also specify that the function delete the instance of RSOP_PolicySetting.

Syntax

USERENVAPI HRESULT RsopResetPolicySettingStatus(
  [in] DWORD            dwFlags,
  [in] IWbemServices    *pServices,
  [in] IWbemClassObject *pSettingInstance
);

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 also point to the instance's children.

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 link (associate) the RSOP_PolicySettingStatus instance to its RSOP_PolicySetting instance, you can call the RSoPSetPolicySettingStatus 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