Metodo IOpcFactory::CreatePartUri (msopc.h)

Articolo
03/13/2024

Crea un oggetto URI di parte che rappresenta un nome di parte.

Sintassi

HRESULT CreatePartUri(
  [in]          LPCWSTR     pwzUri,
  [out, retval] IOpcPartUri **partUri
);

Parametri

[in] pwzUri

URI che rappresenta la posizione di una parte relativa alla radice del pacchetto che lo contiene.

[out, retval] partUri

Puntatore all'interfaccia IOpcPartUri dell'oggetto URI della parte. Questo oggetto rappresenta il nome della parte derivato dall'URI passato in pwzUri.

I nomi delle parti devono essere conformi alla sintassi specificata in OPC.

Valore restituito

Il metodo restituisce un valore 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	Almeno uno dei parametri pwzUri e partUri è NULL.
OPC_E_NONCONFORMING_URI 0x80510001	Un nome di parte non può essere la stringa vuota "".
OPC_E_NONCONFORMING_URI 0x80510001	Un nome di parte non può essere "/".
OPC_E_NONCONFORMING_URI 0x80510001	Un nome di parte non può iniziare con "//".
OPC_E_NONCONFORMING_URI 0x80510001	Un nome di parte non può terminare con un '/'.
OPC_E_NONCONFORMING_URI 0x80510001	Un nome di parte non può terminare con un '.'.
OPC_E_NONCONFORMING_URI 0x80510001	Un nome di parte non può avere segmenti che terminano con un '.'.
OPC_E_NONCONFORMING_URI 0x80510001	Un nome di parte non può avere un componente di frammento. Un componente frammento è preceduto da un carattere '#', come descritto in RFC 3986: sintassi generica URI.
OPC_E_NONCONFORMING_URI 0x80510001	Un nome di parte non può essere il nome di una parte Relazioni che indica un'altra parte Relazioni come origine delle relazioni contenute.
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 CreateUri	Codice di errore HRESULT dalla funzione CreateUri .
Errore WinINet	Codice di errore HRESULT da un'API WinINet .

Commenti

Supporto nelle 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 con l'API per la creazione di pacchetti e l'aggiornamento della piattaforma per Windows Vista.

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, 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