SWbemObject.References_ metodo

Articolo
06/13/2023

Il metodo References_ dell'oggetto SWbemObject restituisce una raccolta di tutte le classi di associazione o istanze che fanno riferimento all'oggetto corrente.

Questo metodo esegue la stessa funzione della query REFERENCES OF WQL.

Per una spiegazione di questa sintassi, vedere Convenzioni di documento per l'API scripting.

Sintassi

objWbemObjectSet = .References_( _
  [ ByVal strResultClass ], _
  [ ByVal strRole ], _
  [ ByVal bClassesOnly ], _
  [ ByVal bSchemaOnly ], _
  [ ByVal strRequiredQualifier ], _
  [ ByVal iFlags ], _
  [ ByVal objwbemNamedValueSet ] _
)

Parametri

strResultClass [in, facoltativo]: Stringa contenente un nome di classe. Se specificato, questo parametro indica che gli oggetti di associazione restituiti devono appartenere o essere derivati dalla classe specificata in questo parametro.
strRole [in, facoltativo]: Stringa contenente un nome di proprietà. Se specificato, questo parametro indica che gli oggetti di 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 [in, facoltativo]: Valore booleano che indica se deve essere restituito un elenco di nomi di classi anziché istanze effettive delle classi. Si tratta delle classi a cui appartengono gli oggetti di associazione. 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 in cui viene richiamato questo metodo è 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 [in, facoltativo]: Stringa contenente un nome qualificatore. Se specificato, questo parametro indica che gli oggetti di associazione restituiti devono includere il qualificatore specificato.
iFlags [in, facoltativo]: Intero che specifica altri flag all'operazione. Il valore predefinito 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)): Causa la restituzione di un enumeratore forward-only. Gli enumeratori solo in avanti sono in genere molto più veloci e usano meno memoria rispetto agli enumeratori convenzionali, ma non consentono chiamate a SWbemObject.Clone_.
wbemFlagBidirectional (0 (0x0)): Causa la conservazione dei puntatori agli oggetti dell'enumerazione fino a quando il client rilascia l'enumeratore.
wbemFlagReturnImmediately (16 (0x10)): Causa la restituzione immediata della chiamata.
wbemFlagReturnWhenComplete (0 (0x0)): Causa il blocco della chiamata fino al completamento della query.
wbemFlagUseAmendedQualifiers (131072 (0x20000)): Consente a WMI di restituire i dati di modifica della classe con la definizione della classe di base. Per altre informazioni sui qualificatori modificati, vedere Localizzazione delle informazioni sulla classe WMI.

objwbemNamedValueSet [in, 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.

Valore restituito

Se la chiamata ha esito positivo, viene restituito un oggetto SWbemObjectSet .

Codici di errore

Al termine del metodo References_ , 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.

Commenti

Per altre informazioni sulle query WQL associate, 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_SWbemObject
IID	IID_ISWbemObject

Vedi anche

SWbemObject
SWbemObject.Associators_
SWbemServices.AssociatorsOf
SWbemServices.ReferencesTo

Condividi tramite