Metodo IOpcRelationshipSet::CreateRelationship (msopc.h)

Articolo
08/25/2023

Crea un oggetto relazione che rappresenta una relazione specificata, quindi aggiunge al set un puntatore all'interfaccia IOpcRelationship dell'oggetto.

Sintassi

HRESULT CreateRelationship(
  [in]          LPCWSTR             relationshipIdentifier,
  [in]          LPCWSTR             relationshipType,
  [in]          IUri                *targetUri,
  [in]          OPC_URI_TARGET_MODE targetMode,
  [out, retval] IOpcRelationship    **relationship
);

Parametri

[in] relationshipIdentifier

Identificatore univoco della relazione da rappresentare come oggetto relazione. Per usare un identificatore generato in modo casuale, passare NULL a questo parametro.

Gli identificatori validi sono conformi alle restrizioni per xsd:ID, documentate nella sezione 3.3.8 ID della raccomandazione W3C, XML Schema Part 2: Datatypes Second Edition (http://www.w3.org/TR/xmlschema-2/#ID).

[in] relationshipType

Tipo di relazione che definisce il ruolo della relazione da rappresentare come oggetto relazione.

[in] targetUri

URI alla destinazione della relazione da rappresentare come oggetto relazione.

Se il valore in targetMode è OPC_URI_TARGET_MODE_INTERNAL, target è una parte e l'URI deve essere relativo all'origine della relazione.

Se il valore in targetMode è OPC_URI_TARGET_MODE_EXTERNAL, target è una risorsa esterna al pacchetto e l'URI può essere assoluto o relativo alla posizione del pacchetto.

Per altre informazioni sull'URI della destinazione di una relazione, vedere OPC.

[in] targetMode

Valore che indica se la destinazione della relazione da rappresentare come oggetto relazione è interna o esterna al pacchetto.

[out, retval] relationship

Puntatore all'interfaccia IOpcRelationship dell'oggetto relazione che rappresenta la relazione.

Questo parametro può essere NULL se non è necessario un puntatore al nuovo oggetto.

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_INVALIDARG	Il valore passato nel parametro targetMode non è un valore di enumerazione valido OPC_URI_TARGET_MODE .
E_POINTER	Almeno uno dei parametri relationshipType e targetUri è NULL.
OPC_E_DUPLICATE_RELATIONSHIP 0x80510013	Esiste già una relazione con lo stesso identificatore nel pacchetto corrente.
OPC_E_INVALID_RELATIONSHIP_ID 0x80510010	L'attributo Id di una relazione non è conforme alle regole specificate in OPC.
OPC_E_INVALID_RELATIONSHIP_TARGET 0x80510012	L'URI in targetUri è assoluto e il valore in targetMode è OPC_URI_TARGET_MODE_INTERNAL. L'URI della destinazione deve essere relativo quando viene specificata questa modalità di destinazione.
OPC_E_INVALID_RELATIONSHIP_TARGET 0x80510012	L'attributo Target di una relazione non è conforme alle regole specificate in OPC.
OPC_E_INVALID_RELATIONSHIP_TYPE 0x80510011	L'attributo Type di una relazione non è conforme alle regole specificate in OPC.
Errore di consumo del pacchetto	Codice di errore HRESULT del gruppo di errori di consumo del pacchetto.
Errore dell'URI della parte	Codice di errore HRESULT del gruppo di errori URI parte.

Commenti

Quando viene creato un oggetto relazione e viene aggiunto un puntatore al set, la relazione che rappresenta viene salvata quando il pacchetto viene salvato.

L'interfaccia IOpcRelationship fornisce l'accesso alle proprietà della relazione. Per informazioni dettagliate su queste proprietà, vedere Panoramica delle relazioni e IOpcRelationship.

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 [solo app desktop]
Server minimo supportato	Windows Server 2008 R2 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	msopc.h