Fungsi ClusterResourceEnum (clusapi.h)

Menghitung sumber daya, simpul, atau keduanya dependen sumber daya. Ini mengembalikan nama satu objek kluster dengan setiap panggilan. Jenis PCLUSAPI_CLUSTER_RESOURCE_ENUM menentukan penunjuk ke fungsi ini.

Sintaks

DWORD ClusterResourceEnum(
  [in]      HRESENUM hResEnum,
  [in]      DWORD    dwIndex,
  [out]     LPDWORD  lpdwType,
  [out]     LPWSTR   lpszName,
  [in, out] LPDWORD  lpcchName
);

Parameter

[in] hResEnum

Handel enumerasi sumber daya yang dikembalikan dari fungsi ClusterResourceOpenEnum .

[in] dwIndex

Indeks sumber daya atau objek simpul yang akan dikembalikan. Parameter ini harus nol untuk panggilan pertama ke fungsi ClusterResourceEnum lalu dinaikkan untuk panggilan berikutnya.

[out] lpdwType

Jenis objek yang dikembalikan oleh ClusterResourceEnum.

Nilai yang mungkin adalah salah satu nilai enumerasi CLUSTER_RESOURCE_ENUM berikut:

CLUSTER_RESOURCE_ENUM_DEPENDS (1)

Objek adalah sumber daya dan hResEnum adalah sumber daya yang bergantung pada objek ini.

CLUSTER_RESOURCE_ENUM_PROVIDES (2)

Objek adalah sumber daya yang bergantung pada sumber daya yang diidentifikasi oleh hResEnum.

CLUSTER_RESOURCE_ENUM_NODES (4)

Objek adalah simpul yang dapat menghosting sumber daya yang diidentifikasi oleh hResEnum.

[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 karakter null yang mengakhiri. Pada output, menentukan jumlah karakter dalam nama yang dihasilkan, tidak termasuk karakter null yang mengakhiri.

Mengembalikan nilai

Fungsi mengembalikan salah satu nilai berikut.

Keterangan

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

Jangan panggil ClusterResourceEnum dari fungsi titik entri DLL sumber daya apa pun. ClusterResourceEnum dapat dengan aman dipanggil dari utas pekerja. Untuk informasi selengkapnya, lihat Panggilan Fungsi untuk Dihindari di DLL Sumber Daya.

Contoh

Lihat Menghitung Objek.

Persyaratan

Lihat juga

Fungsi Manajemen Sumber Daya Kluster

ClusterResourceCloseEnum

ClusterResourceOpenEnum