Método IOpcRelationship::GetTargetUri (msopc.h)
Obtiene el URI del destino de la relación.
Sintaxis
HRESULT GetTargetUri(
[out, retval] IUri **targetUri
);
Parámetros
[out, retval] targetUri
Puntero a la interfaz IUri del URI que representa el URI del destino de la relación.
Si el destino de la relación es interno, el destino es una parte y el URI del destino es relativo al URI de la parte de origen.
Valor devuelto
El método devuelve un valor HRESULT. Entre los valores posibles se incluyen los que se indican en la tabla siguiente, entre otros.
| Código devuelto | Descripción |
|---|---|
|
El método se ha llevado a cabo de forma correcta. |
|
El parámetro targetUri es NULL. |
Comentarios
La forma definitiva de encontrar una parte de interés es mediante un tipo de relación.
La búsqueda de una parte de interés requiere varios pasos. Para obtener información detallada sobre cómo buscar un elemento, vea La información general sobre los elementos y la búsqueda del elemento de propiedades principales.
Para determinar si el destino de la relación es interno o externo, llame al método GetTargetUri .
Si el destino de la relación es interno, el destino es una parte.
Si el destino de la relación es parte, el URI de targetUri es relativo al URI del origen de la relación.
Si el destino de la relación es parte, forme el nombre del elemento llamando al método IOpcUri::CombinePartUri desde el puntero de interfaz IOpcUri recibido en el parámetro sourceUri del método GetSourceUri . Use el URI relativo recibido en targetUri como parámetro de entrada de la llamada IOpcUri::CombinePartUri . Para obtener un ejemplo, consulte Resolución de un nombre de elemento a partir de un URI de destino.
Para obtener más información sobre las relaciones, vea Los aspectos básicos de las convenciones de empaquetado abierto y ecma-376 OpenXML, 1ª edición, parte 2: convenciones de empaquetado abierto (OPC).
Seguridad para subprocesos
Los objetos de empaquetado no son seguros para subprocesos.
Para obtener más información, consulte el Introducción con packaging API.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows 7 [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2008 R2 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | msopc.h |
Consulte también
Recursos externos
Introducción con la API de empaquetado
Aspectos básicos de las convenciones de empaquetado abierto
Temas de introducción
Referencia de API de empaquetado
Ejemplos de API de empaquetado
Referencia