Metodo IOpcUri::CombinePartUri (msopc.h)

Articolo
10/26/2023

Forma il nome della parte a cui fa riferimento l'URI relativo specificato. L'URI relativo specificato della parte viene risolto rispetto all'URI rappresentato come oggetto URI OPC corrente.

Sintassi

HRESULT CombinePartUri(
  [in]          IUri        *relativeUri,
  [out, retval] IOpcPartUri **combinedUri
);

Parametri

[in] relativeUri

Puntatore all'interfaccia IURI dell'URI relativo della parte.

Per formare l'oggetto URI della parte che rappresenta il nome della parte, questo URI di input viene risolto rispetto all'URI rappresentato come oggetto URI OPC corrente. Pertanto, l'URI di input deve essere relativo all'URI rappresentato dall'oggetto URI OPC corrente.

Questo URI può includere un componente frammento; tuttavia, il frammento verrà ignorato e non verrà incluso nel nome della parte da formare. Un componente di frammento è preceduto da un '#', come descritto in RFC 3986: sintassi generica URI.

[out, retval] combinedUri

Puntatore all'interfaccia IOpcPartUri dell'oggetto URI della parte che rappresenta il nome della parte.

L'oggetto URI della parte è formato risolvendo l'URI relativo in relativoUri rispetto all'URI rappresentato dall'oggetto URI OPC corrente.

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_FAIL	La funzione CoInternetCombineUrl ha restituito una dimensione non valida.
E_POINTER	Almeno uno dei parametri relativeUri e combinedUri è NULL.
E_UNEXPECTED	Le dimensioni del buffer richieste dalla funzione CoInternetCombineUrl sono state modificate in modo imprevisto.
OPC_E_NONCONFORMING_URI 0x80510001	Il nome della parte non è conforme alle regole specificate negli standard OPC .
OPC_E_RELATIVE_URI_REQUIRED 0x80510002	Un nome di parte non può essere un URI assoluto. Un URI assoluto inizia con un componente dello schema seguito da un ":", come descritto in RFC 3986: sintassi generica URI.
Errore della funzione CoInternetCombineUrl	Codice di errore HRESULT dalla funzione CoInternetCombineUrl .
Errore della funzione CreateUri	Codice di errore HRESULT dalla funzione CreateUri .
Errore WinINet	Codice di errore HRESULT da un'API WinINet .

Commenti

Input e output di esempio:

IURI relativi all'input	IOpcUri corrente	Formato IOpcPartUri
picture.jpg	/mydoc/markup/page.xml	/mydoc/markup/picture.jpg
.. /picture.jpg	/mydoc/markup/page.xml	/mydoc/picture.jpg
.. /.. /images/picture.jpg	/mydoc/page.xml	/images/picture.jpg

Per informazioni su come usare questo metodo per risolvere un nome di parte, vedere Risoluzione di un nome parte da un URI di destinazione.

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


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