Metodo IOpcRelationship::GetId (msopc.h)

Articolo
08/25/2023

Ottiene l'identificatore univoco della relazione.

Sintassi

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

Parametri

[out, retval] relationshipIdentifier

Identificatore della relazione.

L'identificatore di una relazione è arbitrario e locale per il pacchetto e, pertanto, .

Gli identificatori validi sono conformi alle restrizioni per xsd:ID, documentate nella sezione 3.3.8 ID della raccomandazione W3C, XML Schema Part 2: Datatypes Second Edition (http://www.w3.org/TR/xmlschema-2/#ID).

Valore restituito

Il metodo restituisce un valore HRESULT. I valori possibili includono, ma non sono limitati a, quelli indicati nella tabella seguente.

Codice restituito	Descrizione
S_OK	Il metodo è riuscito.
E_POINTER	Il parametro relationshipIdentifier è NULL.

Commenti

L'identificatore di una relazione non è utile per trovare relazioni perché è arbitrario e locale per il pacchetto.

Il modo definitivo per trovare una parte di interesse consiste nell'usare un tipo di relazione.

La ricerca di una parte richiede diversi passaggi. Per informazioni dettagliate sulla ricerca di una parte, vedere Ricerca della parte delle proprietà di base.

Questo metodo alloca la memoria utilizzata dalla stringa restituita in relationshipIdentifier. Se il metodo ha esito positivo, chiamare la funzione CoTaskMemFree per liberare la memoria.

Per altre informazioni sulle relazioni, vedere Open Packaging Conventions Fundamentals e ECMA-376 OpenXML, 1st Edition, Part 2: Open Packaging Conventions (OPC).For more information about relationships, see the Open Packaging Conventions fundamentals and the ECMA-376 OpenXML, 1st Edition, Part 2: Open Packaging Conventions (OPC).

Thread safety

I pacchetti degli oggetti non sono thread-safe.

Per altre informazioni, vedere l'Introduzione con l'API per la creazione di pacchetti.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 7 [solo app desktop]
Server minimo supportato	Windows Server 2008 R2 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	msopc.h