RSoPSetPolicySettingStatus function

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

HRESULT RSoPSetPolicySettingStatus(
  _In_ DWORD                   dwFlags,
  _In_ IWbemServices           *pServices,
  _In_ IWbemClassObject        *pSettingInstance,
  _In_ DWORD                   nInfo,
  _In_ POLICYSETTINGSTATUSINFO *pStatus
);

Parameters

dwFlags [in]

This parameter is currently unused.

pServices [in]

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

pSettingInstance [in]

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

nInfo [in]

Specifies the number of elements in the pStatus array.

pStatus [in]

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 Overview

Group Policy Functions

RSoPResetPolicySettingStatus

IWbemServices

IWbemClassObject