IOCTL_VOLUME_IS_CLUSTERED IOCTL (winioctl.h)

  • Articolo

Determina se il volume specificato è cluster.

Per eseguire questa operazione, chiamare la funzione DeviceIoControl con i parametri seguenti.

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

Commenti

Il codice di controllo IOCTL_VOLUME_IS_CLUSTERED è valido solo se il servizio cluster è in esecuzione.

L'errore ERROR_GEN_FAILURE indica che il computer che possiede attualmente il disco in cui risiede il volume è un nodo del cluster server, ma il disco è una risorsa disco fisico attualmente in uno stato offline o il disco non è una risorsa Disco fisico. Per determinare quale di queste situazioni esiste, seguire questa procedura:

  1. Chiamare la funzione ClusterEnum per enumerare tutte le risorse del disco fisico nel cluster.
  2. Cercare ogni risorsa disco fisico enumerata per il volume chiamando la funzione ClusterResourceControl con CLUSCTL_RESOURCE_STORAGE_GET_DISK_INFO. Se non è possibile trovare il volume tra le risorse del disco fisico nel cluster, il volume non si trova in una risorsa Disco fisico.

L'errore ERROR_INVALID_FUNCTION indica che il computer attualmente proprietario del disco in cui risiede il volume non è un nodo del cluster server o il disco non è una risorsa Disco fisico. Per determinare se un computer è un nodo del cluster server, chiamare la funzione GetNodeClusterState .

In Windows 8 e Windows Server 2012 questo codice è supportato dalle tecnologie seguenti.

Tecnologia Supportato
Protocollo SMB (Server Message Block) 3.0 No
Failover trasparente SMB 3.0 (TFO) No
SMB 3.0 con condivisioni file con scalabilità orizzontale (SO) No
File system del volume condiviso del cluster (CsvFS) Sì

Requisiti

Requisito Valore
Client minimo supportato Windows XP [solo app desktop]
Server minimo supportato Windows Server 2003 [solo app desktop]
Intestazione winioctl.h (include Windows.h)

Vedi anche