IOpcRelationshipSet::Metode CreateRelationship (msopc.h)

Artikel
03/08/2023

Membuat objek hubungan yang mewakili hubungan tertentu, lalu menambahkan ke set penunjuk ke antarmuka IOpcRelationship objek.

Sintaks

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

Parameter

[in] relationshipIdentifier

Pengidentifikasi unik hubungan yang akan direpresentasikan sebagai objek hubungan. Untuk menggunakan pengidentifikasi yang dihasilkan secara acak, teruskan NULL ke parameter ini.

Pengidentifikasi yang valid sesuai dengan batasan untuk xsd:ID, yang didokumentasikan dalam bagian 3.3.8 ID dari Rekomendasi W3C, Skema XML Bagian 2: Datatypes Edisi Kedua (http://www.w3.org/TR/xmlschema-2/#ID).

[in] relationshipType

Jenis hubungan yang mendefinisikan peran hubungan yang akan direpresentasikan sebagai objek hubungan.

[in] targetUri

URI ke target hubungan yang akan direpresentasikan sebagai objek hubungan.

Jika nilai dalam targetModeOPC_URI_TARGET_MODE_INTERNAL, target adalah bagian dan URI harus relatif terhadap sumber hubungan.

Jika nilai dalam targetModeOPC_URI_TARGET_MODE_EXTERNAL, target adalah sumber daya di luar paket dan URI mungkin absolut atau relatif terhadap lokasi paket.

Untuk informasi selengkapnya tentang URI target hubungan, lihat OPC.

[in] targetMode

Nilai yang menunjukkan apakah target hubungan yang akan direpresentasikan sebagai objek hubungan bersifat internal atau eksternal untuk paket.

[out, retval] relationship

Penunjuk ke antarmuka IOpcRelationship dari objek hubungan yang mewakili hubungan.

Parameter ini bisa NULL jika penunjuk ke objek baru tidak diperlukan.

Nilai kembali

Metode mengembalikan HRESULT. Nilai yang mungkin termasuk, tetapi tidak terbatas pada, yang ada dalam tabel berikut.

Mengembalikan kode/nilai	Deskripsi
S_OK	Metode berhasil.
E_INVALIDARG	Nilai yang diteruskan dalam parameter targetMode bukan nilai enumerasi OPC_URI_TARGET_MODE yang valid.
E_POINTER	Setidaknya salah satu parameter relationshipType dan targetUri adalah NULL.
OPC_E_DUPLICATE_RELATIONSHIP 0x80510013	Hubungan dengan pengidentifikasi yang sama sudah ada dalam paket saat ini.
OPC_E_INVALID_RELATIONSHIP_ID 0x80510010	Atribut Id hubungan tidak sesuai dengan aturan yang ditentukan dalam OPC.
OPC_E_INVALID_RELATIONSHIP_TARGET 0x80510012	URI di targetUri bersifat absolut dan nilai dalam targetModeOPC_URI_TARGET_MODE_INTERNAL. URI target harus relatif ketika mode target ini ditentukan.
OPC_E_INVALID_RELATIONSHIP_TARGET 0x80510012	Atribut Target hubungan tidak sesuai dengan aturan yang ditentukan dalam OPC.
OPC_E_INVALID_RELATIONSHIP_TYPE 0x80510011	Atribut Type hubungan tidak sesuai dengan aturan yang ditentukan dalam OPC.
Kesalahan Konsumsi Paket	Kode kesalahan HRESULT dari Grup Kesalahan Konsumsi Paket.
Kesalahan URI bagian	Kode kesalahan HRESULT dari Grup Kesalahan URI Bagian.

Keterangan

Saat objek hubungan dibuat dan pointer ke dalamnya ditambahkan ke set, hubungan yang diwakilinya disimpan saat paket disimpan.

Antarmuka IOpcRelationship menyediakan akses ke properti hubungan. Untuk detail tentang properti ini, lihat Gambaran Umum Hubungan dan IOpcRelationship.

Keamanan Thread

Objek pengemasan tidak aman untuk rangkaian.

Untuk informasi selengkapnya, lihat Memulai API Kemasan.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 7 [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 R2 [hanya aplikasi desktop]
Target Platform	Windows
Header	msopc.h