IGPM::CreateTrustee method (gpmgmt.h)

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

See also

IGPM

IGPMPermission

IGPMSecurityInfo

IGPMTrustee