Edit

IGPMDomain::GetSOM method (gpmgmt.h)

  • Article

Retrieves the IGPMSOM interface that represents the domain or the organizational unit (OU) at the specified path.

Syntax

HRESULT GetSOM(
  [in]  BSTR    bstrPath,
  [out] IGPMSOM **ppSOM
);

Parameters

[in] bstrPath

Path of the scope of management (SOM) object. The path must be a fully qualified distinguished name. Use the following syntax for the path: (ou=MyOU,dc=domain_name,dc=com).

C++:  If NULL is specified, the method returns a pointer to the IGPMSOM interface for the domain.

Scripting:  If an empty string ("") is specified, the method returns a pointer to the IGPMSOM interface for the domain.

[out] ppSOM

Address of a pointer to the IGPMSOM interface at the specified path.

Return value

C++

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

JScript

Returns a reference to a GPMSOM object.

VB

Returns a reference to a GPMSOM object.

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

IGPMDomain

IGPMSOM