Método IOpcRelationship::GetId (msopc.h)

Artículo
03/05/2024

Obtiene el identificador único de la relación.

Sintaxis

HRESULT GetId(
  [out, retval] LPWSTR *relationshipIdentifier
);

Parámetros

[out, retval] relationshipIdentifier

Identificador de la relación.

El identificador de una relación es arbitrario y local para el paquete y, por lo tanto, .

Los identificadores válidos se ajustan a las restricciones de xsd:ID, que se documentan en la sección 3.3.8 del identificador de la recomendación W3C, esquema XML parte 2: Tipos de datos segunda edición (http://www.w3.org/TR/xmlschema-2/#ID).

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
S_OK	El método se ha llevado a cabo de forma correcta.
E_POINTER	El parámetro relationshipIdentifier es NULL.

Comentarios

El identificador de una relación no es útil para buscar relaciones porque es arbitrario y local para el paquete.

La forma definitiva de encontrar una parte de interés es mediante un tipo de relación.

La búsqueda de un elemento requiere varios pasos. Para obtener información detallada sobre cómo buscar un elemento, vea Buscar el elemento de propiedades principales.

Este método asigna memoria usada por la cadena devuelta en relationshipIdentifier. Si el método se realiza correctamente, llame a la función CoTaskMemFree para liberar la memoria.

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