Metodo SWbemServices.ReferencesTo

Il metodo ReferencesTo dell'oggetto SWbemServices restituisce un insieme di tutte le classi di associazione o istanze che fanno riferimento a una classe o a un'istanza di origine specifica. Questo metodo esegue la stessa funzione eseguita dalla query REFERENCES OF WQL.

Questo metodo viene chiamato in modalità semisynchronous. Per altre informazioni, vedere Chiamata di un metodo.

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

Sintassi

objWbemObjectSet = .ReferencesTo( _
  ByVal strObjectPath, _
  [ ByVal strResultClass ], _
  [ ByVal strRole ], _
  [ ByVal bClassesOnly ], _
  [ ByVal bSchemaOnly ], _
  [ ByVal strRequiredQualifier ], _
  [ ByVal iFlags ], _
  [ ByVal objWbemNamedValueSet ] _
)

Parametri

strObjectPath

Obbligatorio. Stringa contenente il percorso dell'oggetto dell'origine per questo metodo. Per altre informazioni, vedere Descrizione della posizione di un oggetto WMI.

strResultClass [facoltativo]

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

strRole [facoltativo]

Stringa contenente un nome di proprietà. Se specificato, questo parametro indica che gli oggetti associazione restituiti devono essere limitati a quelli 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 o meno un elenco di nomi di classe anziché le istanze effettive delle classi. Si tratta delle classi a cui appartengono gli oggetti di associazione. Il valore predefinito per questo parametro è FALSE.

bSchemaOnly [facoltativo]

Valore booleano che indica se la query si applica o meno 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.

strRequiredQualifier [facoltativo]

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

iFlags [facoltativo]

Intero che specifica flag aggiuntivi per l'operazione. L'impostazione predefinita per questo parametro è wbemFlagReturnImmediately, che indirizza la chiamata a restituire immediatamente anziché attendere il completamento della query. 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 Strumentazione gestione Windows (WMI) mantenga i puntatori agli oggetti dell'enumerazione finché 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 il metodo ha esito positivo, il metodo restituisce un oggetto SWbemObjectSet .

Codici di errore

Dopo il completamento del metodo ReferencesTo , 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.

wbemFlagUseAmendedQualifiers - 131072 (0x20000)

Fa in modo che WMI restituisca i dati di modifica della classe con la definizione della classe di base.

Commenti

Per altre informazioni sulle query WQL associate REFERENCES OF, sulle istanze di origine e sugli oggetti di associazione, 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_SWbemServices
IID	IID_ISWbemServices

Vedi anche

SWbemServices

SWbemObject.Associators_

SWbemObject.References_

SWbemServices.AssociatorsOf