IWSManSession::Enumerate-Methode (wsmandisp.h)

Artikel
08/28/2023

Listet eine Tabelle, Datensammlung oder Protokollressource auf. Um eine Abfrage zu erstellen, schließen Sie einen Filterparameter und einen Dialektparameter in eine Enumeration ein. Sie können auch ein IWSManResourceLocator-Objekt verwenden, um Abfragen zu erstellen. Weitere Informationen finden Sie unter Auflisten oder Auflisten aller Instanzen einer Ressource.

Syntax

HRESULT Enumerate(
  [in]           VARIANT   resourceUri,
  [in, optional] BSTR      filter,
  [in, optional] BSTR      dialect,
  [in]           long      flags,
  [out]          IDispatch **resultSet
);

Parameter

[in] resourceUri

Der Bezeichner der abzurufenden Ressource.

Die folgende Liste enthält Bezeichner, die dieser Parameter enthalten kann:

URI mit mindestens einem Selektor. Verwenden Sie beim Aufrufen der Enumerate-Methode zum Abrufen einer WMI-Ressource die schlüsseleigenschaft oder die Eigenschaften des -Objekts.
Sie können Selektoren, Fragmente oder Optionen verwenden. Weitere Informationen finden Sie unter IWSManResourceLocator.
WS-Adressierungsendpunktreferenz , wie im WS-Management-Protokollstandard beschrieben. Weitere Informationen zur öffentlichen Spezifikation für das WS-Management-Protokoll finden Sie auf der Indexseite für Verwaltungsspezifikationen.

[in, optional] filter

Ein Filter, der definiert, welche Elemente in der Ressource von der -Enumeration zurückgegeben werden. Wenn die Ressource aufgezählt wird, werden nur die Elemente zurückgegeben, die den Filterkriterien entsprechen. Durch das Einschließen eines Filterparameters und eines Dialektparameters in einer Enumeration wird die Enumeration in eine Abfrage konvertiert.

Wenn Sie über ein IWSManResourceLocator-Objekt für den resourceURI-Parameter verfügen, sollte dieser Parameter nicht verwendet werden. Verwenden Sie stattdessen die Selektor- und Fragmentfunktionalität von IWSManResourceLocator.

[in, optional] dialect

Die vom Filter verwendete Sprache. WQL, eine Teilmenge von SQL, die von WMI verwendet wird, ist die einzige unterstützte Sprache.

[in] flags

Dieser Parameter muss ein Flag in der __WSManEnumFlags-Enumeration enthalten. Weitere Informationen finden Sie unter Enumerationskonstanten.

[out] resultSet

Ein IWSManEnumerator-Objekt , das die Ergebnisse der Enumeration enthält.

Rückgabewert

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Rufen Sie IWSManSession::Enumerate auf, um einen Enumerationsvorgang zu starten. Rufen Sie anschließend IWSManEnumerator::ReadItem mithilfe des zurückgegebenen IWSManEnumerator-Objekts auf, bis das Ende der Elemente durch die AtEndOfStream-Eigenschaft angegeben wird.

Beachten Sie folgendes: Wenn die Flags die EnumerationskonstantenWSManFlagHierarchyDeepBasePropsOnly oder WSManFlagHierarchyShallow enthalten, gibt der Windows-Remoteverwaltungsdienst den Fehlercode ERROR_WSMAN_POLYMORPHISM_MODE_UNSUPPORTED zurück.

Weitere Informationen zum Einschränken von Netzwerkaufrufen während einer Enumeration finden Sie in der BatchItems-Eigenschaft .

Wenn ein Filter angegeben wird, muss es sich um ein gültiges Dokument in Bezug auf das Schema der Ressource sein. Der Dialektparameter ist optional. Wenn die Filterzeichenfolge jedoch mit <beginnt, aber kein XML-Fragment ist, schließen Sie entweder den dialekt-Parameter ein, oder legen Sie das WSManFlagNonXmlText-Flag im flags-Parameter fest. Weitere Informationen finden Sie unter Enumerationskonstanten.

Die entsprechende Skriptmethode ist Session.Enumerate.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista
Unterstützte Mindestversion (Server)	Windows Server 2008
Zielplattform	Windows
Kopfzeile	wsmandisp.h
Bibliothek	WSManDisp.tlb
DLL	WSMAuto.dll

Weitere Informationen

IWSManEnumerator

IWSManSession

Session.Enumerate