Metodo IWDTFTarget2::GetRelations (wdtf.h)

Restituisce una raccolta di destinazioni correlate.

Sintassi

HRESULT GetRelations(
  [in]          BSTR          RelationSDEL,
  [in]          BSTR          MatchSDEL,
  [out, retval] IWDTFTargets2 **ppRelations
);

Parametri

[in] RelationSDEL

Istruzione SDEL contenente uno o più token di relazione che specificano le destinazioni desiderate.

[in] MatchSDEL

L'istruzione SDEL che ogni destinazione restituita deve corrispondere. Se MatchSDEL è vuoto, vengono restituite tutte le destinazioni.

[out, retval] ppRelations

Indirizzo della variabile che riceverà il risultato di questo metodo.

Valore restituito

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Si usa il metodo GetRelations per recuperare istanze correlate dell'interfaccia IWDTFTarget2 . Specificare le destinazioni desiderate da un'istruzione SDEL di relazione. In genere, un'istruzione SDEL può contenere token di attributo, operatori di confronto e identificatori di valore per eseguire corrispondenze. Tuttavia, non è necessario che questi elementi nel parametro RelationSDEL per il metodo GetRelations funzionino correttamente (il parametro MatchSDEL segue le regole per il metodo IWDTFTarget2::Eval ).

Il metodo IWDTFTarget2:GetRelations inserisce ogni destinazione correlata trovata dall'istruzione RelationSDEL in una nuova raccolta.

GetRelations restituisce solo il subset di destinazioni che soddisfano i vincoli dei parametri MatchSDEL . Se la stringa di parametro MatchSDEL è vuota, GetRelations restituisce l'intera raccolta di destinazioni. Questo processo filtra tutte le destinazioni che restituiscono VARIANT_FALSE quando si fornisce MatchSDEL al metodo IWDTFTarget2::Eval della destinazione.

Per altre informazioni sull'uso del metodo GetRelations , vedere Panoramica del linguaggio di valutazione dei dati semplice.

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP Professional
Server minimo supportato	Windows Server 2008
Piattaforma di destinazione	Desktop
Intestazione	wdtf.h

Vedi anche

IWDTFTarget2