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_INFOClusterResourceControl 함수를 호출하여 볼륨에 대해 열거된 각 물리적 디스크 리소스를 검색합니다. 클러스터의 물리적 디스크 리소스 중에서 볼륨을 찾을 수 없는 경우 볼륨은 물리적 디스크 리소스에 상주하지 않습니다.

ERROR_INVALID_FUNCTION 오류는 볼륨이 있는 디스크를 현재 소유하고 있는 컴퓨터가 서버 클러스터 노드가 아니거나 디스크가 실제 디스크 리소스가 아님을 나타냅니다. 컴퓨터가 서버 클러스터 노드인지 확인하려면 GetNodeClusterState 함수를 호출합니다.

Windows 8 및 Windows Server 2012 이 코드는 다음 기술에서 지원됩니다.

기술 지원됨
SMB(서버 메시지 블록) 3.0 프로토콜 No
SMB 3.0 TFO(투명 장애 조치(failover)) No
SO(스케일 아웃 파일 공유)를 사용하는 SMB 3.0 No
CsvFS(클러스터 공유 볼륨 파일 시스템) Yes

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2003 [데스크톱 앱만 해당]
머리글 winioctl.h(Windows.h 포함)

추가 정보