VDS_SAN_POLICY Enumeration (vds.h)

[Ab Windows 8 und Windows Server 2012 wird die COM-Schnittstelle des Virtuellen Datenträgerdiensts durch die Windows Storage Management-API ersetzt.]

Definiert den Satz gültiger Datenträger-SAN-Richtlinienflags.

Syntax

typedef enum _VDS_SAN_POLICY {
  VDS_SP_UNKNOWN = 0,
  VDS_SP_ONLINE = 0x1,
  VDS_SP_OFFLINE_SHARED = 0x2,
  VDS_SP_OFFLINE = 0x3,
  VDS_SP_OFFLINE_INTERNAL = 0x4,
  VDS_SP_MAX = 0x5
} VDS_SAN_POLICY;

Konstanten

VDS_SP_UNKNOWN Wert: 0 Die SAN-Richtlinie ist unbekannt.
VDS_SP_ONLINE Wert: 0x1 Alle neu entdeckten Datenträger werden online geschaltet und mit Lese-/Schreibzugriff versehen.
VDS_SP_OFFLINE_SHARED Wert: 0x2 Alle neu ermittelten Datenträger, die sich nicht auf einem freigegebenen Bus befinden, werden online geschaltet und mit Lese-/Schreibzugriff versehen.
VDS_SP_OFFLINE Wert: 0x3 Alle neu ermittelten Datenträger bleiben offline und schreibgeschützt.
VDS_SP_OFFLINE_INTERNAL Wert: 0x4
VDS_SP_MAX Wert: 0x5

Hinweise

Die SAN-Richtlinie bestimmt, ob ein neu ermittelter Datenträger online geschaltet wird oder offline bleibt und ob er lese-/schreibgeschützt ist oder schreibgeschützt bleibt. Wenn ein Datenträger offline ist, kann das Datenträgerlayout gelesen werden, aber keine Volumegeräte werden über Plug & Play (PnP) angezeigt. Dies bedeutet, dass auf dem Datenträger kein Dateisystem eingebunden werden kann. Wenn ein Datenträger online ist, wird für den Datenträger mindestens ein Volumegerät installiert.

Verwenden Sie zum Abfragen der aktuellen SAN-Richtlinie die IVdsServiceSAN::GetSANPolicy-Methode .

Verwenden Sie zum Festlegen der SAN-Richtlinie die IVdsServiceSAN::SetSANPolicy-Methode .

Diese Enumeration ersetzt den NoAutoMount-Registrierungsschlüssel , der unter dem folgenden Registrierungspfad zu finden ist:

HKEY_LOCAL_MACHINE\System\Currentcontrolset\Dienstleistungen\Mountmgr\NoAutoMount

Der Wert dieses Schlüssels ist ein REG_DWORD Wert, der auf 0x00000000 festgelegt ist, um das Feature für die automatische Bereitstellung von Windows oder einen nichtzero-Wert zu aktivieren, um sie zu deaktivieren. Wenn das Feature für die automatische Bereitstellung aktiviert ist, bindet Windows automatisch das Dateisystem für ein neues Basisvolume ein, wenn es dem System hinzugefügt wird, und weist dem Volume dann einen Laufwerkbuchstaben zu. In Systembereichsnetzwerkkonfigurationen verhindert das Deaktivieren der automatischen Bereitstellung, dass Windows laufwerksbuchstaben automatisch allen neuen Basisvolumes zuordnet, die dem System hinzugefügt werden.

Auf Windows Server 2016 ist die STANDARD-SAN-Richtlinie VDS_SP_OFFLINE_SHARED. Dies gilt für alle Editionen und Installationstypen, einschließlich Nano Server.

Unter Windows Server 2008 Enterprise und Windows Server 2008 Datacenter ist die STANDARD-SAN-Richtlinie VDS_SP_OFFLINE_SHARED. In allen anderen Windows Server 2008-Editionen ist die SAN-Standardrichtlinie VDS_SP_ONLINE.

Wenn bei einem Upgrade von einer früheren Version von Windows der Registrierungsschlüssel NoAutoMount vor dem Upgrade festgelegt wurde, löscht das Upgrade diesen Registrierungsschlüssel und legt die SAN-Richtlinie auf VDS_SP_OFFLINE_SHARED fest. (Der NoAutoMount-Registrierungsschlüssel ist unter Windows Server 2008 Enterprise und Windows Server 2008 Datacenter standardmäßig festgelegt.) Wenn der NoAutoMount-Registrierungsschlüssel vor dem Upgrade nicht festgelegt wurde, legt das Upgrade die SAN-Richtlinie auf VDS_SP_ONLINE fest. Darüber hinaus überprüft das Upgrade jeden Datenträger, um zu ermitteln, ob die Volumes auf dem Datenträger online oder offline sind. Wenn ein Datenträger vor dem Upgrade online ist und über ein oder mehrere Onlinevolumes verfügt, werden dieser Datenträger und alle zugehörigen Volumes online gestellt, unabhängig von der SAN-Richtlinie oder ob sich der Datenträger auf einem freigegebenen Bus befindet. Angenommen, ein Onlinedatenträger mit zwei Offlinevolumes und einem Onlinevolume befindet sich auf einem freigegebenen Bus, und der NoAutoMount-Registrierungsschlüssel wird vor dem Upgrade festgelegt. Nach dem Upgrade wird die SAN-Richtlinie VDS_SP_OFFLINE_SHARED, der Datenträger online geschaltet, und alle drei Volumes werden online geschaltet.

Bei einer sauber Installation von Windows bestimmt die SAN-Richtlinie, ob ein Datenträger online oder offline ist, nachdem Windows installiert wurde.

Hinweis In zukünftigen Windows-Versionen können der VDS_SAN_POLICY-Enumeration zusätzliche Konstanten hinzugefügt werden. Aus diesem Grund muss Ihre Anwendung so konzipiert sein, dass sie eine nicht erkannte VDS_SAN_POLICY Enumerationskonstante ordnungsgemäß verarbeitet.

 

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista mit SP1 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Kopfzeile	vds.h

Weitere Informationen

IVdsServiceSAN::GetSANPolicy

IVdsServiceSAN::SetSANPolicy