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
Instrucción SDEL que contiene uno o varios tokens de relación que especifican los destinos deseados.
[in] MatchSDEL
Instrucción SDEL que cada destino devuelto debe coincidir. 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 hrESULT código de error.
Observaciones
Use el método GetRelations para recuperar instancias relacionadas de la interfaz IWDTFTarget2 de. Especifique los destinos deseados por una relación instrucción SDEL. 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 del método IWDTFTarget2::Eval).
El método IWDTFTarget2:GetRelations coloca todos los destinos relacionados que GetRelations encuentra la instrucción RelationSDEL en una nueva colección.
GetRelations devuelve solo el subconjunto de destinos que satisfacen las restricciones de parámetro matchSDEL de. 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 al proporcionar MatchSDEL al método IWDTFTarget2::Eval del destino.
Para obtener más información sobre el uso del método getRelations de, consulte Introducción al lenguaje de evaluación de datos simple.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Windows XP Professional |
| servidor mínimo admitido | Windows Server 2008 |
| de la plataforma de destino de | Escritorio |
| encabezado de | wdtf.h |