IGPMDomain::SearchWMIFilters method (gpmgmt.h)

Article
10/13/2021

Executes a search for GPMWMIFilter objects in the domain and then returns a GPMWMIFilterCollection object.

Syntax

HRESULT SearchWMIFilters(
  [in]  IGPMSearchCriteria      *pIGPMSearchCriteria,
  [out] IGPMWMIFilterCollection **ppIGPMWMIFilterCollection
);

Parameters

[in] pIGPMSearchCriteria

This parameter should be NULL, or it should point to an empty IGPMSearchCriteria interface, because no search criteria are allowed for Windows Management Instrumentation (WMI) filters.

[out] ppIGPMWMIFilterCollection

Address of a pointer to the IGPMWMIFilterCollection interface that represents the WMI filters 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 GPMWMIFilterCollection object.

VB

Returns a reference to a GPMWMIFilterCollection 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 WMI filters.

Requirements

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