Metodo IOpcPartUri::GetSourceUri (msopc.h)

Articolo
02/29/2024

Ottiene l'URI di origine delle relazioni archiviate in una parte Relazioni. L'oggetto URI della parte corrente rappresenta il nome della parte Di relazione.

Sintassi

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

Parametri

[out, retval] sourceUri

Puntatore all'interfaccia IOpcUri dell'oggetto URI OPC che rappresenta l'URI dell'origine delle relazioni archiviate nella parte Relazioni.

Valore restituito

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

Codice/valore restituito	Descrizione
S_OK	Il metodo è riuscito.
E_POINTER	Il parametro sourceUri è NULL.
OPC_E_RELATIONSHIP_URI_REQUIRED 0x80510003	Il nome della parte di una parte Relazioni è obbligatorio, ma il nome della parte non è quello di una parte Relazioni. Per altre informazioni sui nomi delle parti relazioni, vedere OPC.
Errore della funzione CreateUri	Codice di errore HRESULT dalla funzione CreateUri .
Errore WinINet	Codice di errore HRESULT da un'API WinINet .

Commenti

Se l'oggetto URI della parte corrente rappresenta il nome della parte Relazioni che archivia le relazioni del pacchetto ("/_rels/.rels"), l'oggetto URI OPC restituito in sourceUri rappresenta la radice del pacchetto ("/").

Se l'oggetto URI della parte corrente non è il nome della parte di una parte Relationships, questo metodo ha esito negativo con l'errore di OPC_E_RELATIONSHIP_URI_REQUIRED . La sintassi per i nomi delle parti di relazione è specificata nel OPC.

Nella tabella seguente vengono illustrati gli URI della parte corrente e l'URI di origine restituiti da questo metodo.

URI della parte corrente	Descrizione dell'URI della parte corrente	URI di origine	Descrizione dell'URI di origine	Valore restituito
/mydoc/_rels/picture.jpg.rels	Nome parte di una parte Relazioni	/mydoc/picture.jpg	Nome della parte che rappresenta l'origine delle relazioni archiviate nella parte Relazioni rappresentata dall'oggetto URI della parte corrente	S_OK
/_rels/.rels	Nome parte di una parte Relazioni	/	Radice del pacchetto; origine delle relazioni archiviate nella parte Relazioni rappresentata dall'oggetto URI della parte corrente	S_OK
/mydoc/image/chart1.jpg	Nome parte di una parte che non è una parte Relazioni	Non definito	Non definito	OPC_E_RELATIONSHIP_URI_REQUIRED
/_rels/a.jpg	Nome parte di una parte che non è una parte Relazioni	Non definito	Non definito	OPC_E_RELATIONSHIP_URI_REQUIRED

Supporto nelle versioni precedenti di Windows

Il comportamento e le prestazioni di questo metodo sono uguali in tutte le versioni di Windows supportate. Per altre informazioni, vedere Introduzione con l'API Creazione pacchetti e l'aggiornamento della piattaforma per Windows Vista.

Thread safety

Gli oggetti di creazione dei pacchetti non sono thread-safe.

Per altre informazioni, vedere l'Introduzione con l'API Creazione pacchetti.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 7, Windows Vista con SP2 e Aggiornamento della piattaforma per Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 R2, Windows Server 2008 con SP2 e Platform Update per Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	msopc.h