Metodo IWSManSession::Enumerate (wsmandisp.h)

Articolo
03/13/2024

Enumera una tabella, una raccolta di dati o una risorsa di log. Per creare una query, includere un parametro di filtro e un parametro di dialetto in un'enumerazione. È anche possibile usare un oggetto IWSManResourceLocator per creare query. Per altre informazioni, vedere Enumerazione o elenco di tutte le istanze di una risorsa.

Sintassi

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

Parametri

[in] resourceUri

Identificatore della risorsa da recuperare.

L'elenco seguente contiene gli identificatori che questo parametro può contenere:

URI con uno o più selettori. Quando si chiama il metodo Enumerate per ottenere una risorsa WMI, utilizzare la proprietà o le proprietà chiave dell'oggetto.
È possibile usare selettori, frammenti o opzioni. Per altre informazioni, vedere IWSManResourceLocator.
Riferimento all'endpoint WS-Addressing come descritto nello standard del protocollo WS-Management. Per altre informazioni sulla specifica pubblica per il protocollo WS-Management, vedere la pagina relativa all'indice delle specifiche di gestione.

[in, optional] filter

Filtro che definisce gli elementi nella risorsa restituiti dall'enumerazione . Quando la risorsa viene enumerata, vengono restituiti solo gli elementi che corrispondono ai criteri di filtro. L'inclusione di un parametro di filtro e di un parametro di dialetto in un'enumerazione converte l'enumerazione in una query.

Se si dispone di un oggetto IWSManResourceLocator per il parametro resourceURI , questo parametro non deve essere usato. Usare invece la funzionalità selettore e frammento di IWSManResourceLocator.

[in, optional] dialect

Lingua utilizzata dal filtro. WQL, un subset di SQL usato da WMI, è l'unico linguaggio supportato.

[in] flags

Questo parametro deve contenere un flag nell'enumerazione __WSManEnumFlags . Per altre informazioni, vedere Costanti di enumerazione.

[out] resultSet

Oggetto IWSManEnumerator che contiene i risultati dell'enumerazione.

Valore restituito

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Chiamare IWSManSession::Enumerate per avviare un'operazione di enumerazione. Successivamente, chiamare IWSManEnumerator::ReadItem usando l'oggetto IWSManEnumerator restituito fino a quando la fine degli elementi non viene indicata dalla proprietà AtEndOfStream .

Tenere presente che se i flag includono le costanti di enumerazioneWSManFlagHierarchyDeepBasePropsOnly o WSManFlagHierarchyShallow , il servizio Gestione remota Windows restituisce il codice di errore ERROR_WSMAN_POLYMORPHISM_MODE_UNSUPPORTED.

Per altre informazioni sulla limitazione delle chiamate di rete durante un'enumerazione, vedere la proprietà BatchItems .

Se viene specificato un filtro, deve essere un documento valido rispetto allo schema della risorsa. Il parametro di dialetto è facoltativo. Tuttavia, se la stringa di filtro inizia con <, ma non è un frammento XML, includere il parametro di dialetto o impostare il flag WSManFlagNonXmlText nel parametro flags . Per altre informazioni, vedere Costanti di enumerazione.

Il metodo di scripting corrispondente è Session.Enumerate.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista
Server minimo supportato	Windows Server 2008
Piattaforma di destinazione	Windows
Intestazione	wsmandisp.h
Libreria	WSManDisp.tlb
DLL	WSMAuto.dll

Vedi anche

IWSManEnumerator

IWSManSession

Session.Enumerate