共用方式為

IOCTL_VOLUME_IS_CLUSTERED IOCTL (winioctl.h)

  • 發行項

判斷指定的磁碟區是否已叢集化。

若要執行這項作業，請使用下列參數呼叫 DeviceIoControl 函 式。

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
);

備註

只有在叢集服務正在執行時， IOCTL_VOLUME_IS_CLUSTERED 控制程式代碼才有效。

ERROR_GEN_FAILURE錯誤指出目前擁有磁碟區所在的磁碟的計算機是伺服器叢集節點，但磁碟是目前處於離線狀態的實體磁碟資源，或磁碟不是實體磁碟資源。 若要判斷有哪些情況存在，請使用下列步驟：

  1. 呼叫 ClusterEnum 函式以列舉叢集中的所有實體磁碟資源。
  2. 使用 CLUSCTL_RESOURCE_STORAGE_GET_DISK_INFO 呼叫 ClusterResourceControl 函式，以搜尋磁碟區的每個列舉實體磁碟資源。 如果您在叢集中的實體磁碟資源中找不到磁碟區，磁碟區就不會位於實體磁碟資源上。

ERROR_INVALID_FUNCTION錯誤表示目前擁有磁碟區所在的磁碟的計算機不是伺服器叢集節點，或磁碟不是實體磁碟資源。 若要判斷計算機是否為伺服器叢集節點，請呼叫 GetNodeClusterState 函式。

在 Windows 8 和 Windows Server 2012 中，下列技術支援此程序代碼。

技術 支援
伺服器消息塊 (SMB) 3.0 通訊協定 No
SMB 3.0 透明故障轉移 (TFO) No
具有向外延展檔案共用的SMB 3.0 (SO) No
叢集共用磁碟區文件系統 (CsvFS) Yes

規格需求

需求 值
最低支援的用戶端 Windows XP [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 [僅限桌面應用程式]
標頭 winioctl.h (包含 Windows.h)

另請參閱