Metodo SWbemServices.AssociatorsOf
Il metodo AssociatorsOf dell'oggetto SWbemServices restituisce una raccolta di oggetti (classi o istanze) denominati endpoint associati a un oggetto specificato. Questo metodo esegue la stessa funzione eseguita dalla query ASSOCIATORS OF WQL.
Questo metodo viene chiamato nella modalità semisynchronous per impostazione predefinita. Per altre informazioni, vedere Chiamata di un metodo.
Per una spiegazione di questa sintassi, vedere Document Conventions per l'API di scripting.
Sintassi
objWbemObjectSet = .AssociatorsOf( _
ByVal strObjectPath, _
[ ByVal strAssocClass ], _
[ ByVal strResultClass ], _
[ ByVal strResultRole ], _
[ ByVal strRole ], _
[ ByVal bClassesOnly ], _
[ ByVal bSchemaOnly ], _
[ ByVal strRequiredAssocQualifier ], _
[ ByVal strRequiredQualifier ], _
[ ByVal iFlags ], _
[ ByVal objwbemNamedValueSet ] _
)
Parametri
-
strObjectPath
-
Obbligatorio. Stringa contenente il percorso dell'oggetto della classe o dell'istanza di origine. 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 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 [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 impostata su TRUE, il set di endpoint restituiti rappresenta classi che sono adeguatamente associate 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 flag aggiuntivi per l'operazione. Il valore predefinito per questo parametro è wbemFlagReturnImmediately, che chiama il metodo in modalità semisynchronous. Questo parametro può accettare i valori seguenti.
-
wbemFlagForwardOnly (32 (0x20))
-
Fa sì che venga restituito un enumeratore forward-only. Gli enumeratori forward-only sono in genere molto più veloci e usano meno memoria rispetto agli enumeratori convenzionali, ma non consentono chiamate a SWbemObject.Clone_.
-
wbemFlagBidirectional (0 (0x0))
-
Fa sì che WMI mantenga i puntatori agli oggetti dell'enumerazione fino a quando il client non rilascia l'enumeratore.
-
wbemFlagReturnImmediately (16 (0x10))
-
Fa sì che la chiamata venga restituita immediatamente.
-
wbemFlagReturnWhenComplete (0 (0x0))
-
Determina il blocco di questa chiamata fino al completamento della query. Questo flag chiama il metodo in modalità sincrona.
-
wbemFlagUseAmendedQualifiers (131072 (0x20000))
-
Fa sì che WMI restituisca dati di modifica della classe insieme alla definizione della classe di base. Per altre informazioni, vedere Localizzazione delle informazioni sulla classe WMI.
objwbemNamedValueSet [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.
Valore restituito
Se la chiamata ha esito positivo, viene restituito un oggetto SWbemObjectSet .
Codici di errore
Dopo il completamento del metodo AssociatorsOf , l'oggetto Err può contenere uno dei codici di errore nell'elenco seguente.
Nota
Una raccolta restituita con zero elementi non è un errore.
-
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)
-
Impossibile trovare l'elemento richiesto.
Commenti
Il metodo recupera le istanze delle risorse gestite associate a una risorsa specificata tramite una o più classi di associazione. Specificare il percorso dell'oggetto per l'endpoint di origine e AssociatorsOf restituisce le risorse gestite nell'endpoint opposto. Il metodo AssociatorsOf esegue la stessa funzione eseguita dalla query ASSOCIATORS OF WQL.
Per altre informazioni sulla query ASSOCIATORS OF WQL, 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 |
|
| Libreria dei tipi |
|
| DLL |
|
| CLSID |
CLSID_SWbemServices |
| IID |
IID_ISWbemServices |