Fungsi CreateCluster (clusapi.h)

Membuat dan memulai kluster. Kluster terdiri dari set simpul yang ditentukan, dengan Nama Jaringan, Alamat IP, dan sumber daya kuorum jika ditentukan. Jenis PCLUSAPI_CREATE_CLUSTER menentukan penunjuk ke fungsi ini.

Syntax

HCLUSTER CreateCluster(
  [in]           PCREATE_CLUSTER_CONFIG           pConfig,
  [in, optional] PCLUSTER_SETUP_PROGRESS_CALLBACK pfnProgressCallback,
  [in, optional] PVOID                            pvCallbackArg
);

Parameter-parameternya

[in] pConfig

Alamat struktur CREATE_CLUSTER_CONFIG yang berisi informasi konfigurasi tentang kluster yang akan dibuat.

[in, optional] pfnProgressCallback

Alamat fungsi panggilan balik yang cocok dengan PCLUSTER_SETUP_PROGRESS_CALLBACK penunjuk fungsi yang akan dipanggil secara berkala untuk memberikan kemajuan pada pembuatan kluster.

[in, optional] pvCallbackArg

Argumen untuk fungsi panggilan balik.

Mengembalikan nilai

Tangani ke kluster yang baru dibuat atau NULL. Nilai non NULL tidak menunjukkan keberhasilan lengkap (semua simpul akan ditambahkan, tetapi tidak semua alamat IP atau sumber daya Nama Jaringan mungkin telah dibuat. Parameter yang diteruskan ke fungsi yang diarahkan oleh parameter pfnProgressCallback harus diperiksa.

Komentar

Jenis PCLUSAPI_CREATE_CLUSTER menentukan penunjuk ke fungsi ini dan dapat digunakan dengan fungsi GetProcAddress untuk memanggil fungsi ini.

Setelah fungsi CreateCluster berhasil diselesaikan, setidaknya 30 detik harus diizinkan sebelum fungsi AddClusterNode dipanggil untuk menambahkan simpul tambahan.

Fungsi CreateCluster berhasil diselesaikan setelah kuorum kluster tercapai. Satu atau beberapa node kluster dapat berada dalam status ClusterNodeDown atau ClusterNodeJoining selama beberapa detik.

Sebelum memanggil fungsi CreateCluster , fungsi CoInitializeEx harus disebut menentukan COINIT_MULTITHREADED dan COINIT_DISABLE_OLE1DDE untuk parameter dwCoInit , seperti yang ditunjukkan dalam kode berikut.

CoInitializeEx( NULL, COINIT_MULTITHREADED | COINIT_DISABLE_OLE1DDE );

Persyaratan

Lihat juga

AddClusterNode

CREATE_CLUSTER_CONFIG

Fungsi Manajemen Kluster

DestroyCluster

PCLUSTER_SETUP_PROGRESS_CALLBACK