IOCTL_VOLUME_IS_CLUSTERED IOCTL (winioctl.h)

  • Artigo

Determina se o volume especificado está clusterizado.

Para executar essa operação, chame a função DeviceIoControl com os parâmetros a seguir.

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

Comentários

O código de controle IOCTL_VOLUME_IS_CLUSTERED só será válido se o serviço cluster estiver em execução.

O erro ERROR_GEN_FAILURE indica que o computador que atualmente possui o disco no qual o volume reside é um nó de cluster de servidor, mas o disco é um recurso de Disco Físico atualmente em um estado offline ou o disco não é um recurso de Disco Físico. Para determinar qual dessas situações existe, use as seguintes etapas:

  1. Chame a função ClusterEnum para enumerar todos os recursos de Disco Físico no cluster.
  2. Pesquise cada recurso de Disco Físico enumerado para o volume chamando a função ClusterResourceControl com CLUSCTL_RESOURCE_STORAGE_GET_DISK_INFO. Se você não conseguir encontrar o volume entre os recursos do Disco Físico no cluster, o volume não residirá em um recurso de Disco Físico.

O erro ERROR_INVALID_FUNCTION indica que o computador que atualmente possui o disco no qual o volume reside não é um nó de cluster de servidor ou o disco não é um recurso de Disco Físico. Para determinar se um computador é um nó de cluster de servidor, chame a função GetNodeClusterState .

Em Windows 8 e Windows Server 2012, esse código é compatível com as tecnologias a seguir.

Tecnologia Com suporte
Protocolo SMB (SMB) 3.0 No
TFO (Failover transparente) do SMB 3.0 No
SMB 3.0 com compartilhamentos de arquivos de expansão (SO) No
Sistema de arquivos de Volume Compartilhado Clusterizado (CsvFS) Sim

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Cabeçalho winioctl.h (inclua Windows.h)

Confira também