Fungsi OpenClusterEx (clusapi.h)

Membuka koneksi ke kluster dan mengembalikan handel ke dalamnya.

Sintaks

HCLUSTER OpenClusterEx(
  [in, optional]  LPCWSTR lpszClusterName,
  [in]            DWORD   DesiredAccess,
  [out, optional] DWORD   *GrantedAccess
);

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.

[in] DesiredAccess

Hak istimewa akses yang diminta. Ini mungkin kombinasi GENERIC_READ (0x80000000), GENERIC_ALL (0x10000000), atau MAXIMUM_ALLOWED (0x02000000). Jika nilai ini adalah nol (0) dan kesalahan yang tidak ditentukan dapat dikembalikan. Menggunakan GENERIC_ALL sama dengan memanggil OpenCluster.

[out, optional] GrantedAccess

Parameter opsional yang berisi alamat DWORD yang akan menerima hak akses yang diberikan. Jika parameter DesiredAccessMAXIMUM_ALLOWED (0x02000000) maka DWORD yang ditujukkan oleh parameter ini akan berisi hak istimewa maksimum yang diberikan kepada pengguna ini.

Nilai kembali

Jika operasi berhasil, OpenClusterEx mengembalikan handel kluster.

Mengembalikan kode/nilai	Deskripsi
NULL 0	Operasi tidak berhasil. Untuk informasi selengkapnya tentang kesalahan, panggil fungsi GetLastError . Jika server target tidak mendukung fungsi OpenClusterEx (misalnya jika server target menjalankan Windows Server 2008 atau yang lebih lama) maka fungsi GetLastError akan mengembalikan RPC_S_PROCNUM_OUT_OF_RANGE (1745).

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 handel LPC 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 dikosongkan dan koneksi dimatikan dengan bersih.

Persyaratan

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