Metodo SWbemServices.AssociatorsOfAsync
Il metodo AssociatorsOfAsync dell'oggetto SWbemServices restituisce una raccolta di oggetti (classi o istanze) denominati endpoint associati a un oggetto specificato. La chiamata a AssociatorsOfAsync restituisce immediatamente e i risultati e lo stato vengono restituiti al chiamante tramite eventi recapitati al sink specificato in objWbemSink. Per gestire ogni oggetto restituito, creare un oggetto objWbemSink. Gestore eventi OnObjectReady .
Dopo l'arrivo di tutti gli oggetti, l'elaborazione viene eseguita nell'objWbemSink. Evento OnCompleted . Questo metodo esegue la stessa funzione eseguita dalla query ASSOCIATORS OF WQL. Per altre informazioni sulla creazione di un sink, vedere Ricezione di un evento WMI.
Il metodo viene chiamato nella modalità asincrona. Per altre informazioni, vedere Chiamata di un metodo.
Per una spiegazione di questa sintassi, vedere Convenzioni di documento per l'API scripting.
Sintassi
SWbemServices.AssociatorsOfAsync( _
ByVal objWbemSink, _
ByVal strObjectPath, _
[ ByVal strAssocClass ], _
[ ByVal strResultClass ], _
[ ByVal strResultRole ], _
[ ByVal strRole ], _
[ ByVal bClassesOnly ], _
[ ByVal bSchemaOnly ], _
[ ByVal strRequiredAssocQualifier ], _
[ ByVal strRequiredQualifier ], _
[ ByVal iFlags ], _
[ ByVal objWbemNamedValueSet ], _
[ ByVal objWbemAsyncContext ] _
)
Parametri
-
objWbemSink
-
Obbligatorio. Sink oggetto che riceve gli oggetti in modo asincrono. Creare un oggetto SWbemSink per ricevere gli oggetti.
-
strObjectPath
-
Obbligatorio. Stringa contenente il percorso dell'oggetto della classe di origine o dell'istanza. Per altre informazioni, vedere Descrizione della posizione di un oggetto WMI.
-
strAssocClass [facoltativo]
-
Stringa contenente una classe di associazione. Se specificato, questo parametro indica che gli endpoint restituiti devono essere associati all'origine tramite la classe di associazione specificata o una classe derivata da questa classe di associazione.
-
strResultClass [facoltativo]
-
Stringa contenente un nome di classe. Se specificato, questo parametro facoltativo indica che gli endpoint restituiti devono appartenere o essere derivati dalla classe specificata in questo parametro.
-
strResultRole [facoltativo]
-
Stringa contenente un nome di proprietà. Se specificato, questo parametro indica che gli endpoint restituiti devono svolgere un ruolo specifico nell'associazione con l'oggetto di origine. Il ruolo è definito dal nome di una proprietà specificata (che deve essere una proprietà di riferimento) di un'associazione.
-
strRole [facoltativo]
-
Stringa contenente un nome di proprietà. Se specificato, questo parametro indica che gli endpoint restituiti devono partecipare a un'associazione con l'oggetto di origine in cui l'oggetto di origine svolge un ruolo specifico. Il ruolo è definito dal nome di una proprietà specificata (che deve essere una proprietà di riferimento) di un'associazione.
-
bClassesOnly [facoltativo]
-
Valore booleano che indica se deve essere restituito un elenco di nomi di classi anziché istanze effettive delle classi. Queste sono le classi a cui appartengono le istanze dell'endpoint. Il valore predefinito per questo parametro è FALSE.
-
bSchemaOnly [facoltativo]
-
Valore booleano che indica se la query si applica allo schema anziché ai dati. Il valore predefinito per questo parametro è FALSE. Può essere impostato su TRUE solo se il parametro strObjectPath specifica il percorso dell'oggetto di una classe. Se impostato su TRUE, il set di endpoint restituiti rappresenta le classi associate in modo adeguato alla classe di origine nello schema.
-
strRequiredAssocQualifier [facoltativo]
-
Stringa contenente un nome qualificatore. Se specificato, questo parametro indica che gli endpoint restituiti devono essere associati all'oggetto di origine tramite una classe di associazione che include il qualificatore specificato.
-
strRequiredQualifier [facoltativo ]
-
Stringa contenente un nome qualificatore. Se specificato, questo parametro indica che gli endpoint restituiti devono includere il qualificatore specificato.
-
iFlags [facoltativo]
-
Intero che specifica i flag aggiuntivi all'operazione. Il valore predefinito per questo parametro è wbemFlagDontSendStatus. Questo parametro può accettare i valori seguenti.
-
wbemFlagSendStatus (128 (0x80))
-
Causa chiamate asincrone per inviare gli aggiornamenti dello stato al gestore eventi OnProgress per il sink di oggetti.
-
wbemFlagDontSendStatus (0 (0x0))
-
Impedisce alle chiamate asincrone di inviare aggiornamenti dello stato al gestore eventi OnProgress per il sink di oggetti.
-
wbemFlagUseAmendedQualifiers (131072 (0x20000))
-
Consente a WMI di restituire i dati di modifica della classe insieme alla definizione della classe di base. Per altre informazioni sui qualificatori modificati, vedere Localizzazione delle informazioni sulla classe WMI.
objWbemNamedValueSet [facoltativo]
In genere, questo è indefinito. In caso contrario, si tratta di un oggetto SWbemNamedValueSet i cui elementi rappresentano le informazioni di contesto che possono essere usate dal provider che esegue la manutenzione della richiesta. Un provider che supporta o richiede tali informazioni deve documentare i nomi di valore riconosciuti, il tipo di dati del valore, i valori consentiti e la semantica.
objWbemAsyncContext [facoltativo]
Oggetto SWbemNamedValueSet che restituisce al sink dell'oggetto per identificare l'origine della chiamata asincrona originale. Usare questo parametro se si effettuano più chiamate asincrone usando lo stesso sink di oggetti. Per usare questo parametro, creare un oggetto SWbemNamedValueSet e usare il metodo SWbemNamedValueSet.Add per aggiungere un valore che identifica la chiamata asincrona eseguita. Questo oggetto SWbemNamedValueSet viene restituito al sink dell'oggetto e l'origine della chiamata può essere estratta usando il metodo SWbemNamedValueSet.Item . Per altre informazioni, vedere Chiamata di un metodo.
Valore restituito
Questo metodo non restituisce valori. Se ha esito positivo, il sink riceve un evento OnObjectReady per ogni istanza. Dopo l'ultima istanza, il sink dell'oggetto riceve un evento OnCompleted .
Codici di errore
Al termine del metodo AssociatorsOfAsync , l'oggetto Err può contenere uno dei codici di errore nell'elenco seguente.
-
wbemErrAccessDenied - 2147749891 (0x80041003)
-
L'utente corrente non dispone dell'autorizzazione per visualizzare una o più classi restituite dalla chiamata.
-
wbemErrFailed - 2147749889 (0x80041001)
-
Errore non specificato.
-
wbemErrInvalidParameter - 2147749896 (0x80041008)
-
È stato specificato un parametro non valido.
-
wbemErrOutOfMemory - 2147749894 (0x80041006)
-
Memoria insufficiente per completare l'operazione.
-
wbemErrNotFound - 2147749890 (0x80041002)
-
Elemento richiesto non trovato.
Commenti
Questa chiamata restituisce immediatamente. Gli oggetti e lo stato richiesti vengono restituiti al chiamante tramite callback recapitati al sink specificato in objWbemSink. Per elaborare ogni oggetto quando viene restituito, creare un objWbemSink. Subroutine dell'evento OnObjectReady . Dopo aver restituito tutti gli oggetti, è possibile eseguire l'elaborazione finale nell'implementazione dell'objWbemSink. Evento OnCompleted .
Un callback asincrono consente a un utente non autenticato di fornire dati al sink. Ciò comporta rischi di sicurezza per gli script e le applicazioni. Per eliminare i rischi, vedere Impostazione della sicurezza in una chiamata asincrona.
Usare il parametro objWbemAsyncContext negli script per verificare l'origine di una chiamata.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato |
Windows Vista |
| Server minimo supportato |
Windows Server 2008 |
| Intestazione |
|
| Libreria dei tipi |
|
| DLL |
|
| CLSID |
CLSID_SWbemServices |
| IID |
IID_ISWbemServices |