Método IWDTFTarget2::GetRelations (wdtf.h)
Devuelve una colección de destinos relacionados.
Sintaxis
HRESULT GetRelations(
[in] BSTR RelationSDEL,
[in] BSTR MatchSDEL,
[out, retval] IWDTFTargets2 **ppRelations
);
Parámetros
[in] RelationSDEL
Una instrucción SDEL que contiene uno o varios tokens de relación que especifican los destinos deseados.
[in] MatchSDEL
Instrucción SDEL que debe coincidir cada destino devuelto. Si MatchSDEL está vacío, se devuelven todos los destinos.
[out, retval] ppRelations
Dirección de la variable que recibirá el resultado de este método.
Valor devuelto
Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.
Comentarios
Use el método GetRelations para recuperar instancias relacionadas de la interfaz IWDTFTarget2 . Los destinos deseados se especifican mediante una instrucción SDEL de relación. Normalmente, una instrucción SDEL puede contener tokens de atributo, operadores de comparación y especificadores de valor para realizar coincidencias. Sin embargo, no necesita estos elementos en el parámetro RelationSDEL para que el método GetRelations funcione correctamente (el parámetro MatchSDEL sigue las reglas para el método IWDTFTarget2::Eval ).
El método IWDTFTarget2:GetRelations coloca todos los destinos relacionados que GetRelations encuentra mediante la instrucción RelationSDEL en una nueva colección.
GetRelations devuelve solo el subconjunto de destinos que satisfacen las restricciones de parámetro MatchSDEL . Si la cadena de parámetro MatchSDEL está vacía, GetRelations devuelve toda la colección de destinos. Este proceso filtra todos los destinos que devuelven VARIANT_FALSE cuando se proporciona MatchSDEL al método IWDTFTarget2::Eval del destino.
Para obtener más información sobre el uso del método GetRelations , vea Información general sobre el lenguaje de evaluación de datos simple.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows XP Professional |
| Servidor mínimo compatible | Windows Server 2008 |
| Plataforma de destino | Escritorio |
| Encabezado | wdtf.h |