Bagikan melalui

Fungsi ClusterResourceControl (clusapi.h)

  • Artikel

Memulai operasi yang memengaruhi sumber daya. Operasi yang dilakukan tergantung pada kode kontrol yang diteruskan ke parameter dwControlCode .

Sintaks

DWORD ClusterResourceControl(
  [in]            HRESOURCE hResource,
  [in, optional]  HNODE     hHostNode,
  [in]            DWORD     dwControlCode,
  [in, optional]  LPVOID    lpInBuffer,
  [in]            DWORD     cbInBufferSize,
  [out, optional] LPVOID    lpOutBuffer,
  [in]            DWORD     cbOutBufferSize,
  [out, optional] LPDWORD   lpBytesReturned
);

Parameter

[in] hResource

Tangani ke sumber daya yang akan terpengaruh.

[in, optional] hHostNode

Handel opsional ke simpul untuk melakukan operasi. Jika NULL, simpul yang memiliki sumber daya yang diidentifikasi oleh hResource melakukan operasi.

[in] dwControlCode

Kode kontrol sumber daya, dijumlahkan oleh enumerasi CLUSCTL_RESOURCE_CODES, menentukan operasi yang akan dilakukan. Untuk sintaks yang terkait dengan kode kontrol, lihat
Arsitektur Kode Kontrol dan topik berikut:

[in, optional] lpInBuffer

Penunjuk ke buffer input yang berisi informasi yang diperlukan untuk operasi, atau NULL jika tidak ada informasi yang diperlukan.

[in] cbInBufferSize

Ukuran yang dialokasikan (dalam byte) dari buffer input.

[out, optional] lpOutBuffer

Pointer ke buffer output untuk menerima data yang dihasilkan dari operasi, atau NULL jika tidak ada data yang akan dikembalikan.

[in] cbOutBufferSize

Ukuran yang dialokasikan (dalam byte) dari buffer output.

[out, optional] lpBytesReturned

Mengembalikan ukuran aktual (dalam byte) data yang dihasilkan dari operasi. Jika informasi ini tidak diperlukan, teruskan NULL untuk lpBytesReturned.

Menampilkan nilai

Fungsi mengembalikan salah satu nilai berikut.

Mengembalikan kode/nilai Deskripsi
ERROR_SUCCESS
0
 Operasi berhasil. Jika operasi memerlukan buffer output, lpBytesReturned (jika tidak NULL pada input) menunjuk ke ukuran aktual data yang dikembalikan dalam buffer.
ERROR_MORE_DATA
234 (0xEA)
 Buffer output yang ditunjukkan oleh lpOutBuffer tidak cukup besar untuk menyimpan data yang dihasilkan dari operasi. Parameter lpBytesReturned (jika tidak NULL pada input) menunjuk ke ukuran yang diperlukan untuk buffer output. Hanya operasi yang memerlukan ERROR_MORE_DATA pengembalian buffer output. Jika parameter lpOutBuffer adalah NULL dan parameter cbOutBufferSize adalah nol, maka ERROR_SUCCESS dapat dikembalikan, bukan ERROR_MORE_DATA.
ERROR_RESOURCE_PROPERTIES_STORED
5024 (0x13A0)
 Hanya berlaku untuk CLUSCTL_RESOURCE_SET_COMMON_PROPERTIES dan CLUSCTL_RESOURCE_SET_PRIVATE_PROPERTIES. Menunjukkan bahwa properti berhasil disimpan tetapi belum diterapkan ke sumber daya. Properti baru akan berlaku setelah sumber daya diambil offline dan dibawa online lagi.
ERROR_HOST_NODE_NOT_RESOURCE_OWNER
5015 (0x1397)
 Simpul yang ditentukan oleh parameter hNode bukan simpul yang memiliki sumber daya yang ditentukan oleh hResource.
Kode kesalahan sistem
 Operasi tidak berhasil. Jika operasi memerlukan buffer output, nilai yang ditentukan oleh lpBytesReturned (jika tidak NULL pada input) tidak dapat diandalkan.

Keterangan

Saat ClusterResourceControl mengembalikan ERROR_MORE_DATA, atur cbOutBufferSize ke jumlah byte yang ditunjukkan oleh lpBytesReturned, dan panggil fungsi lagi.

Jangan meneruskan handel LPC dan RPC ke panggilan fungsi yang sama. Jika tidak, panggilan akan menaikkan pengecualian RPC dan dapat memiliki efek merusak tambahan. Untuk informasi tentang cara penanganan LPC dan RPC dibuat, lihat Penanganan LPC dan RPC dan OpenCluster.

Fungsi ClusterResourceControl adalah salah satu fungsi kode kontrol. Untuk informasi selengkapnya tentang kode kontrol dan fungsi kode kontrol, lihat Menggunakan Kode Kontrol.

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

OpenCluster

Kode Kontrol Sumber Daya