Método IOpcPartUri::GetSourceUri (msopc.h)

Artículo
08/25/2023

Obtiene el URI de origen de las relaciones almacenadas en una parte De relaciones. El objeto URI de la parte actual representa el nombre de la parte Relaciones.

Sintaxis

HRESULT GetSourceUri(
  [out, retval] IOpcUri **sourceUri
);

Parámetros

[out, retval] sourceUri

Puntero a la interfaz IOpcUri del objeto URI de OPC que representa el URI del origen de las relaciones almacenadas en la parte Relaciones.

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 o valor devuelto	Descripción
S_OK	El método se ha llevado a cabo de forma correcta.
E_POINTER	El parámetro sourceUri es NULL.
OPC_E_RELATIONSHIP_URI_REQUIRED 0x80510003	Se requiere el nombre de elemento de una parte De relaciones, pero el nombre del elemento no es el de una parte De relaciones. Para obtener más información sobre los nombres de los elementos De relaciones, consulte OPC.
Error de la función CreateUri	Código de error HRESULT de la función CreateUri .
Error de WinINet	Código de error HRESULT de una API de WinINet .

Comentarios

Si el objeto URI de parte actual representa el nombre de la parte Relaciones que almacena las relaciones de paquete ("/_rels/.rels"), el objeto URI de OPC devuelto en sourceUri representará la raíz del paquete ("/").

Si el objeto URI de la parte actual no es el nombre de parte de un elemento Relationships, este método produce el error OPC_E_RELATIONSHIP_URI_REQUIRED . La sintaxis de los nombres de elementos relationship se especifica en el OPC.

En la tabla siguiente se muestran los URI de parte actuales posibles y el URI de origen que este método devolvería.

URI de la parte actual	Descripción del URI de la parte actual	URI de origen	Descripción del URI de origen	Valor devuelto
/mydoc/_rels/picture.jpg.rels	Nombre de elemento de un elemento De relaciones	/mydoc/picture.jpg	Nombre de elemento del elemento que es el origen de las relaciones almacenadas en la parte Relaciones representada por el objeto URI de parte actual.	S_OK
/_rels/.rels	Nombre de elemento de un elemento De relaciones	/	Raíz del paquete; el origen de las relaciones almacenadas en la parte Relaciones representada por el objeto URI de parte actual	S_OK
/mydoc/image/chart1.jpg	Nombre de elemento de un elemento que no es un elemento De relaciones	No definido	No definido	OPC_E_RELATIONSHIP_URI_REQUIRED
/_rels/a.jpg	Nombre de elemento de un elemento que no es un elemento De relaciones	No definido	No definido	OPC_E_RELATIONSHIP_URI_REQUIRED

Compatibilidad con versiones anteriores de Windows

El comportamiento y el rendimiento de este método son los mismos en todas las versiones de Windows compatibles. Para obtener más información, consulte Introducción con la API de empaquetado y Actualización de plataforma para Windows Vista.

Seguridad para subprocesos

Los objetos de empaquetado no son seguros para subprocesos.

Para más información, consulte la Introducción con la API de empaquetado.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 7, Windows Vista con SP2 y Actualización de plataforma para Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 R2, Windows Server 2008 con SP2 y Actualización de plataforma para Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	msopc.h