IGPMDomain::GetSOM method (gpmgmt.h)
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 |