metodo SWbemObject.AssociatorsAsync_

Il metodo AssociatorsAsync_ di SWbemObject ottiene oggetti (classi o istanze) associati all'oggetto corrente. Questi oggetti sono denominati endpoint. Questo metodo esegue la stessa funzione eseguita dalla query ASSOCIATORS OF WQL.

Per una spiegazione di questa sintassi, vedere Document Conventions per l'API di scripting.

Sintassi

SWbemObject.AssociatorsAsync_( _
  ByVal objWbemSink, _
  [ ByVal strAssocClass ], _
  [ ByVal strResultClass ], _
  [ ByVal strResultRole ], _
  [ ByVal strRole ], _
  [ ByVal bClassesOnly ], _
  [ ByVal bSchemaOnly ], _
  [ ByVal strRequiredAssocQualifier ], _
  [ ByVal strRequiredQualifier ], _
  [ ByVal iFlags ], _
  [ ByVal objwbemNamedValueSet ], _
  [ ByVal objWbemAsyncContext ] _
)

Parametri

objWbemSink [in]

Obbligatorio. Sink oggetto che riceve gli oggetti in modo asincrono come callback.

strAssocClass [in, 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 [in, facoltativo]

Stringa contenente un nome di classe. Se specificato, questo parametro indica che gli endpoint restituiti devono appartenere o essere derivati dalla classe specificata in questo parametro.

strResultRole [in, 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 [in, 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 [in, facoltativo]

Valore booleano che indica se deve essere restituito un elenco di nomi di classe anziché le istanze effettive delle classi. Si tratta delle classi a cui appartengono le istanze dell'endpoint. Il valore predefinito per questo parametro è FALSE.

bSchemaOnly [in, 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 l'oggetto su cui viene richiamato questo metodo è una classe . Se impostato su TRUE, il set di endpoint restituiti rappresenta classi associate adeguatamente alla classe di origine nello schema.

strRequiredAssocQualifier [in, 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 [in, facoltativo]

Stringa contenente un nome qualificatore. Se specificato, questo parametro indica che gli endpoint restituiti devono includere il qualificatore specificato.

iFlags [in, facoltativo]

Intero che specifica flag aggiuntivi per l'operazione. Questo parametro può accettare i valori seguenti.

wbemFlagSendStatus (128 (0x80))

Fa sì che le chiamate asincrone inviino aggiornamenti dello stato al gestore eventi SWbemSink.OnProgress per il sink dell'oggetto.

wbemFlagDontSendStatus (0 (0x0))

Impedisce alle chiamate asincrone di inviare aggiornamenti dello stato al gestore eventi OnProgress per il sink dell'oggetto.

wbemFlagUseAmendedQualifiers (131072 (0x20000))

Fa in modo che WMI restituisca la classe localizzata e le descrizioni delle proprietà. Per altre informazioni, vedere Localizzazione delle informazioni sulla classe WMI.

objwbemNamedValueSet [in, facoltativo]

In genere, questo non è definito. In caso contrario, si tratta di un oggetto SWbemNamedValueSet i cui elementi rappresentano le informazioni di contesto che possono essere utilizzate dal provider che sta servendo la richiesta. Un provider che supporta o richiede tali informazioni deve documentare i nomi dei valori riconosciuti, il tipo di dati del valore, i valori consentiti e la semantica.

objWbemAsyncContext [in, facoltativo]

Si tratta di un oggetto SWbemNamedValueSet che restituisce al sink dell'oggetto per identificare l'origine della chiamata asincrona originale. Utilizzare questo parametro se si eseguono più chiamate asincrone usando lo stesso sink dell'oggetto. Per utilizzare questo parametro, creare un oggetto SWbemNamedValueSet e utilizzare 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. In caso di 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

Dopo il completamento del metodo AssociatorsAsync_ , 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 - 2147449889 (0x7FFF7C21)

Errore non specificato.

wbemErrInvalidParameter - 2147749896 (0x80041008)

Un parametro specificato non è valido.

wbemErrOutOfMemory - 2147749894 (0x80041006)

Memoria insufficiente per completare l'operazione.

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 all'arrivo, creare un oggetto objWbemSink. Subroutine dell'evento OnObjectReady . Dopo che tutti gli oggetti vengono restituiti, è possibile eseguire l'elaborazione finale nell'implementazione di objWbemSink. Evento OnCompleted .

Un callback asincrono consente a un utente non autenticato di fornire dati al sink. Ciò comporta rischi per la sicurezza per gli script e le applicazioni. Per eliminare i rischi, usare la comunicazione semiincrona o la comunicazione sincrona. Per altre informazioni, vedere Chiamata di un metodo.

Per altre informazioni sull'ASSOCIATORS OF query WQL associate, sulle istanze di origine e sugli endpoint, vedere ASSOCIATORS OF Statement.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista
Server minimo supportato	Windows Server 2008
Intestazione	Wbemdisp.h
Libreria dei tipi	Wbemdisp.tlb
DLL	Wbemdisp.dll
CLSID	CLSID_SWbemObject
IID	IID_ISWbemObject

Vedi anche

SWbemObject

SWbemServices.AssociatorsOfAsync

SWbemObject.References_

SWbemServices.ReferencesTo