Metodo IOpcUri::GetRelativeUri (msopc.h)

Forma un URI relativo per una parte specificata, rispetto all'URI rappresentato dall'oggetto URI OPC corrente.

Sintassi

HRESULT GetRelativeUri(
  [in]          IOpcPartUri *targetPartUri,
  [out, retval] IUri        **relativeUri
);

[in] targetPartUri

Puntatore all'interfaccia IOpcPartUri dell'oggetto URI della parte che rappresenta il nome della parte da cui è formato l'URI relativo.

[out, retval] relativeUri

Puntatore all'interfaccia IUri dell'URI della parte, rispetto all'oggetto URI OPC corrente.

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	Almeno uno dei parametri targetPartUri e relativePartUri è NULL.
Errore della funzione CreateUri	Codice di errore HRESULT dalla funzione CreateUri .
Errore WinINet	Codice di errore HRESULT da un'API WinINet .

Input e output di esempio:

Input IOpcPartUri rappresenta	IOpcUri corrente rappresenta	Rappresenta l'IUri relativo restituito
/mydoc/markup/page.xml	/mydoc/markup/picture.jpg	picture.jpg
/mydoc/markup/page.xml	/mydoc/picture.jpg	.. /picture.jpg
/mydoc/markup/page.xml	/mydoc/images/pictures.jpg	.. /images/pictures.jpg

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

I pacchetti degli oggetti non sono thread-safe.

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