IGPMDomain::SearchGPOs method (gpmgmt.h)

Article
02/22/2024

Executes a search for GPMGPO objects in the domain and then returns a GPMGPOCollection object.

Syntax

HRESULT SearchGPOs(
  [in]  IGPMSearchCriteria *pIGPMSearchCriteria,
  [out] IGPMGPOCollection  **ppIGPMGPOCollection
);

Parameters

[in] pIGPMSearchCriteria

GPMSearchCriteria object to apply to the search. Pointer to the criteria to apply to the search.

[out] ppIGPMGPOCollection

Address of a pointer to the IGPMGPOCollection interface representing the GPOs found by the search.

Return value

C++

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

JScript

Returns a reference to a GPMGPOCollection object.

VB

Returns a reference to a GPMGPOCollection object.

Remarks

An empty GPMSearchCriteria object is one that has had no criteria added to it. Passing in an empty GPMSearchCriteria object will return all GPOs in the domain.

Requirements

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