Fungsi OpenCluster (clusapi.h)

Membuka koneksi ke kluster dan mengembalikan handel ke kluster tersebut.

Sintaks

HCLUSTER OpenCluster(
  [in, optional] LPCWSTR lpszClusterName
);

Parameter

[in, optional] lpszClusterName

Menentukan salah satu nilai berikut:

• Penunjuk ke string Unicode yang dihentikan null yang berisi nama kluster atau salah satu node kluster yang dinyatakan sebagai nama NetBIOS, nama DNS yang sepenuhnya memenuhi syarat, atau alamat IP. Ini menghasilkan handel kluster RPC.
• NULL, yang menghasilkan handel LPC ke kluster tempat komputer lokal berada.

Nilai kembali

Jika operasi berhasil, OpenCluster mengembalikan handel kluster.

Mengembalikan kode/nilai	Deskripsi
NULL 0	Operasi tidak berhasil. Untuk informasi selengkapnya tentang kesalahan, panggil fungsi GetLastError.

Keterangan

Handel kluster adalah penunjuk ke struktur yang ditentukan secara internal yang menyimpan informasi tentang koneksi RPC atau LPC ke kluster. Setiap handel objek yang diperoleh dari handel kluster akan dikaitkan dengan data sesi RPC atau LPC yang disimpan dalam struktur kluster. Menggabungkan RPC dan LPC menangani atau menggunakan handel yang diperoleh dari konteks yang berbeda dapat menyebabkan pengecualian atau hasil lain yang tidak dapat diprediksi. Untuk informasi selengkapnya, lihat Handel LPC dan RPC.

Setelah selesai dengan handel kluster, penting untuk memanggil CloseCluster untuk memastikan bahwa semua memori dibebaskan dan koneksi dimatikan dengan bersih.

Jika kluster jarak jauh, klien harus menjalankan sistem operasi yang kompatibel. Misalnya komputer yang menjalankan Windows Server 2008 tidak dapat memanggil OpenCluster terhadap kluster yang menjalankan Windows Server 2016. Untuk mengelola kluster ini dari jarak jauh, gunakan Penyedia WMI Kluster Failover.

Contoh

Lihat Menggunakan Handel Objek.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Tidak ada yang didukung
Server minimum yang didukung	Pusat Data Windows Server 2008 Enterprise, Windows Server 2008
Target Platform	Windows
Header	clusapi.h
Pustaka	ClusAPI.lib
DLL	ClusAPI.dll

Lihat juga

CloseCluster

Fungsi Manajemen Kluster Failover

OpenClusterEx