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

Minimum supported client

Windows Vista

Minimum supported server

Windows Server 2008

Header

Userenv.h

Library

Userenv.lib

DLL

Userenv.dll

See also

Group Policy Overview
Group Policy Functions
RSoPResetPolicySettingStatus
IWbemServices
IWbemClassObject

 

 

Show: