Share via

IOCTL_VOLUME_IS_CLUSTERED IOCTL (winioctl.h)

  • Artikel

Menentukan apakah volume yang ditentukan diklusterkan.

Untuk melakukan operasi ini, panggil fungsi DeviceIoControl dengan parameter berikut.

BOOL DeviceIoControl(
  (HANDLE) hDevice,             // handle to device
  IOCTL_VOLUME_IS_CLUSTERED,    // dwIoControlCode
  NULL,                         // lpInBuffer
  0,                            // nInBufferSize
  NULL,                         // lpOutBuffer
  0,                            // nOutBufferSize
  (LPDWORD) lpBytesReturned,    // number of bytes returned
  (LPOVERLAPPED) lpOverlapped   // OVERLAPPED structure
);

Keterangan

Kode kontrol IOCTL_VOLUME_IS_CLUSTERED hanya valid jika layanan Kluster berjalan.

Kesalahan ERROR_GEN_FAILURE menunjukkan bahwa komputer yang saat ini memiliki disk tempat volume berada adalah node kluster server, tetapi disk adalah sumber daya Disk Fisik yang saat ini dalam keadaan offline atau disk bukan sumber daya Disk Fisik. Untuk menentukan situasi mana yang ada, gunakan langkah-langkah berikut:

  1. Panggil fungsi ClusterEnum untuk menghitung semua sumber daya Disk Fisik dalam kluster.
  2. Cari setiap sumber daya Disk Fisik yang dijumlahkan untuk volume dengan memanggil fungsi ClusterResourceControl dengan CLUSCTL_RESOURCE_STORAGE_GET_DISK_INFO. Jika Anda tidak dapat menemukan volume di antara sumber daya Disk Fisik di kluster, volume tidak berada di sumber daya Disk Fisik.

Kesalahan ERROR_INVALID_FUNCTION menunjukkan bahwa komputer yang saat ini memiliki disk tempat volume berada bukan node kluster server atau disk bukan sumber daya Disk Fisik. Untuk menentukan apakah komputer adalah node kluster server, panggil fungsi GetNodeClusterState .

Di Windows 8 dan Windows Server 2012, kode ini didukung oleh teknologi berikut.

Teknologi Didukung
Protokol Server Message Block (SMB) 3.0 Tidak
SMB 3.0 Transparent Failover (TFO) Tidak
SMB 3.0 dengan Scale-out File Shares (SO) Tidak
Sistem File Volume Bersama Kluster (CsvFS) Ya

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows XP [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2003 [hanya aplikasi desktop]
Header winioctl.h (termasuk Windows.h)

Lihat juga