IOCTL_VOLUME_IS_CLUSTERED IOCTL (winioctl.h)

  • Artikel

Ermittelt, ob das angegebene Volume geclustert ist.

Um diesen Vorgang auszuführen, rufen Sie die Funktion DeviceIoControl mit den folgenden Parametern auf.

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

Hinweise

Der IOCTL_VOLUME_IS_CLUSTERED-Steuerelementcode ist nur gültig, wenn der Clusterdienst ausgeführt wird.

Der fehler ERROR_GEN_FAILURE gibt an, dass der Computer, auf dem sich derzeit der Datenträger befindet, auf dem sich das Volume befindet, ein Serverclusterknoten ist, aber entweder handelt es sich bei dem Datenträger um eine Physische Datenträgerressource, die sich derzeit im Offlinezustand befindet, oder dass es sich bei dem Datenträger nicht um eine Ressource für physische Datenträger handelt. Führen Sie die folgenden Schritte aus, um zu bestimmen, welche dieser Situationen vorhanden ist:

  1. Rufen Sie die ClusterEnum-Funktion auf, um alle Physische Datenträgerressourcen im Cluster aufzulisten.
  2. Durchsuchen Sie jede aufgezählte physische Datenträgerressource nach dem Volume, indem Sie die ClusterResourceControl-Funktion mit CLUSCTL_RESOURCE_STORAGE_GET_DISK_INFO aufrufen. Wenn Sie das Volume unter den Ressourcen für physische Datenträger im Cluster nicht finden können, befindet sich das Volume nicht auf einer physischen Datenträgerressource.

Der ERROR_INVALID_FUNCTION-Fehler gibt an, dass der Computer, auf dem sich derzeit der Datenträger befindet, auf dem sich das Volume befindet, kein Serverclusterknoten ist oder dass der Datenträger keine physische Datenträgerressource ist. Um zu bestimmen, ob ein Computer ein Serverclusterknoten ist, rufen Sie die GetNodeClusterState-Funktion auf.

In Windows 8 und Windows Server 2012 wird dieser Code von den folgenden Technologien unterstützt.

Technologie Unterstützt
SMB 3.0-Protokoll (Server Message Block) No
SMB 3.0 Transparent Failover (TFO) No
SMB 3.0 mit Dateifreigaben mit horizontaler Skalierung (SO) No
Dateisystem mit freigegebenen Clustervolumes (CsvFS) Ja

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Kopfzeile winioctl.h (windows.h einschließen)

Weitere Informationen