Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Ottiene l'URI di origine delle relazioni archiviate in una parte Relazioni. L'oggetto URI della parte corrente rappresenta il nome della parte della parte Relationships.
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 solo, quelli nella tabella seguente.
| Codice/valore restituito | Description |
|---|---|
|
Il metodo è riuscito. |
|
Il parametro sourceUri è NULL. |
|
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 delle relazioni, vedere OPC. |
|
Codice di errore HRESULT della funzione CreateUri . |
|
Codice di errore HRESULT da un'API WinINet . |
Osservazioni:
Se l'oggetto URI della parte corrente rappresenta il nome della parte Relazioni che archivia le relazioni tra pacchetti ("/_rels/.rels"), l'oggetto URI OPC restituito in sourceUri rappresenterà 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 OPC_E_RELATIONSHIP_URI_REQUIRED . La sintassi per i nomi delle parti di relazione viene specificata in OPC.
La tabella seguente mostra i possibili URI della parte corrente e l'URI di origine che verrebbe restituito 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 della parte di una parte Relazioni | /mydoc/picture.jpg | Nome della parte della parte che rappresenta l'origine delle relazioni archiviate nella parte Relazioni rappresentata dall'oggetto URI della parte corrente | S_OK |
| /_rels/.rels | Nome della 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 della parte di una parte che non è una parte Relazioni | Non definito | Non definito | OPC_E_RELATIONSHIP_URI_REQUIRED |
| /_rels/a.jpg | Nome della parte di una parte che non è una parte Relazioni | Non definito | Non definito | OPC_E_RELATIONSHIP_URI_REQUIRED |
Supporto per le versioni precedenti di Windows
Il comportamento e le prestazioni di questo metodo sono gli stessi in tutte le versioni di Windows supportate. Per altre informazioni, vedere Introduzione all'API di creazione pacchetti e Aggiornamento della piattaforma per Windows Vista.Sicurezza dei Thread
I pacchetti di oggetti non sono thread-safe.
Per altre informazioni, vedere Introduzione all'API di creazione di pacchetti.
Requisiti
| Requisito | Value |
|---|---|
| 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 Aggiornamento della piattaforma per Windows Server 2008 [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Header | msopc.h |
Vedere anche
Risorse esterne
Introduzione all'API di creazione di pacchetti
Concetti fondamentali sulle convenzioni per la creazione di pacchetti aperti
Panoramiche
Informazioni di riferimento sulle API per la creazione di pacchetti
Esempi di API per la creazione di pacchetti
Aggiornamento della piattaforma per Windows Vista
Riferimento