Fungsi ClusterNodeEnum (clusapi.h)

Menghitung antarmuka jaringan atau grup yang diinstal pada simpul, mengembalikan nama masing-masing dengan setiap panggilan. Jenis PCLUSAPI_CLUSTER_NODE_ENUM mendefinisikan penunjuk ke fungsi ini.

Sintaks

DWORD ClusterNodeEnum(
  [in]      HNODEENUM hNodeEnum,
  [in]      DWORD     dwIndex,
  [out]     LPDWORD   lpdwType,
  [out]     LPWSTR    lpszName,
  [in, out] LPDWORD   lpcchName
);

Parameter

[in] hNodeEnum

Tangani ke objek enumerasi yang ada yang awalnya dikembalikan oleh fungsi ClusterNodeOpenEnum .

[in] dwIndex

Indeks yang digunakan untuk mengidentifikasi entri berikutnya yang akan dijumlahkan. Parameter ini harus nol untuk panggilan pertama ke ClusterNodeEnum dan kemudian dinaikkan untuk panggilan berikutnya.

[out] lpdwType

Penunjuk ke jenis objek yang dikembalikan. Nilai enumerasi CLUSTER_NODE_ENUM berikut dikembalikan dengan setiap panggilan.

CLUSTER_NODE_ENUM_NETINTERFACES (1)

Objek adalah antarmuka jaringan.

CLUSTER_NODE_ENUM_GROUPS (0x00000002)

Objek adalah grup kluster.

Windows Server 2008: Nilai CLUSTER_NODE_ENUM_GROUPS tidak didukung sebelum Windows Server 2008 R2.

[out] lpszName

Penunjuk ke string Unicode yang dihentikan null yang berisi nama objek yang dikembalikan.

[in, out] lpcchName

Penunjuk ke ukuran buffer lpszName sebagai hitungan karakter. Pada input, tentukan jumlah maksimum karakter yang dapat ditahan buffer, termasuk NULL yang mengakhiri. Pada output, menentukan jumlah karakter dalam nama yang dihasilkan, tidak termasuk NULL yang mengakhiri.

Nilai kembali

Fungsi mengembalikan salah satu nilai berikut.

Mengembalikan kode/nilai	Deskripsi
ERROR_SUCCESS 0	Operasi berhasil diselesaikan.
ERROR_NO_MORE_ITEMS 259 (0x103)	Tidak ada lagi data yang tersedia. Nilai ini dikembalikan jika tidak ada lagi objek dari jenis yang diminta untuk dikembalikan.
ERROR_MORE_DATA 234 (0xEA)	Lebih banyak data tersedia. Nilai ini dikembalikan jika buffer yang ditunjukkan oleh lpszName tidak cukup besar untuk menahan hasilnya. Parameter lpcchName mengembalikan jumlah karakter dalam hasil, tidak termasuk NULL yang mengakhiri.

Keterangan

Untuk menggunakan ClusterNodeEnum, aplikasi terlebih dahulu membuka handel enumerasi simpul dengan memanggil ClusterNodeOpenEnum dengan parameter dwType diatur ke CLUSTER_NODE_ENUM_NETINTERFACES. Untuk informasi selengkapnya, lihat Menghitung Objek.

Perhatikan bahwa parameter lpcchName mengacu pada hitungan karakter dan bukan hitungan byte, dan bahwa ukuran yang dikembalikan tidak menyertakan NULL yang mengakhiri dalam hitungan. Untuk informasi selengkapnya tentang buffer ukuran, lihat Konvensi Ukuran Data.

Contoh

Lihat Menghitung 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

ClusterNodeCloseEnum

ClusterNodeOpenEnum

Fungsi Manajemen Simpul