RsopSetPolicySettingStatus function (userenv.h)

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

See also

Group Policy Functions

Group Policy Overview

IWbemClassObject

IWbemServices

RSoPResetPolicySettingStatus