IOpcRelationship ::GetId, méthode (msopc.h)

Article
03/06/2024

Obtient l’identificateur unique de la relation.

Syntaxe

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

Paramètres

[out, retval] relationshipIdentifier

Identificateur de la relation.

L’identificateur d’une relation est arbitraire et local pour le package, et, par conséquent, .

Les identificateurs valides sont conformes aux restrictions pour xsd :ID, qui sont documentées dans la section 3.3.8 ID de la recommandation W3C, XML Schema Part 2 : Datatypes Second Edition (http://www.w3.org/TR/xmlschema-2/#ID).

Valeur retournée

Cette méthode retourne un code HRESULT. Les valeurs possibles sont notamment celles figurant dans le tableau suivant.

Code de retour	Description
S_OK	S_OK
E_POINTER	Le paramètre relationshipIdentifier est NULL.

Remarques

L’identificateur d’une relation n’est pas utile pour rechercher des relations, car il est arbitraire et local dans le package.

La façon définitive de trouver une partie d’intérêt consiste à utiliser un type de relation.

La recherche d’un composant nécessite plusieurs étapes. Pour plus d’informations sur la recherche d’un composant, consultez Recherche du composant Propriétés principales.

Cette méthode alloue la mémoire utilisée par la chaîne retournée dans relationshipIdentifier. Si la méthode réussit, appelez la fonction CoTaskMemFree pour libérer la mémoire.

Pour plus d’informations sur les relations, consultez Open Packaging Conventions Fundamentals et ECMA-376 OpenXML, 1st Edition, Part 2 : Open Packaging Conventions (OPC) .

Cohérence de thread

Les objets d’empaquetage ne sont pas thread-safe.

Pour plus d’informations, consultez la Prise en main avec l’API d’empaquetage.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 7 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 R2 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	msopc.h