IGPMSitesContainer::SearchSites method (gpmgmt.h)

Article
02/22/2024

Retrieves a collection of scope of management (SOM) objects based on the specified search criteria. This method returns only site objects.

Syntax

HRESULT SearchSites(
  [in]  IGPMSearchCriteria *pIGPMSearchCriteria,
  [out] IGPMSOMCollection  **ppIGPMSOMCollection
);

Parameters

[in] pIGPMSearchCriteria

Pointer to criteria to supply to the search. Valid criteria for the search include the following.

somLinks

Pointer to an IDispatch or an IUnknown interface to query the IGPMGPO interface. For script programmers, this is a reference to a GPMGPO object. Valid criteria includes the opContains search operator.

[out] ppIGPMSOMCollection

Address of a pointer to the IGPMSOMCollection interface.

Return value

C++

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

JScript

Returns a reference to a GPMSOMCollection object.

VB

Returns a reference to a GPMSOMCollection object.

Requirements

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