IGPM::CreateTrustee method (gpmgmt.h)

Article
02/22/2024

Creates and returns a GPMTrustee from which you can retrieve information about a trustee. A trustee is a user, computer, or security group that can be granted permissions on a Group Policy object (GPO), scope of management (SOM), or Windows Management Instrumentation (WMI) filter.

Syntax

HRESULT CreateTrustee(
  [in]  BSTR        bstrTrustee,
  [out] IGPMTrustee **ppIGPMTrustee
);

Parameters

[in] bstrTrustee

Required. Trustee name or the security identifier (SID). Names are in a format that is compatible with Security Accounts Manager (SAM), such as Exampledomain\Someone.

[out] ppIGPMTrustee

Address of a pointer to the IGPMTrustee interface.

Return value

C++

Returns S_OK if successful. Returns a failure code if an error occurs.

JScript

Returns a reference to a GPMTrustee object.

VB

Returns a reference to a GPMTrustee object.

Remarks

For more information about policy-related permissions, see IGPM::CreatePermission. For more information about security groups, see How Security Groups are Used in Access Control in the Active Directory Programmer's Guide.

Requirements

Requirement	Value
Minimum supported client	Windows Vista
Minimum supported server	Windows Server 2008
Target Platform	Windows
Header	gpmgmt.h
DLL	Gpmgmt.dll