énumération VDS_SAN_POLICY (vds.h)

Article
03/08/2023

[À compter de Windows 8 et Windows Server 2012, l’interface COM du service de disque virtuel est remplacée par l’API Gestion du stockage Windows.]

Définit l’ensemble d’indicateurs de stratégie SAN de disque valides.

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;

Constantes


`VDS_SP_UNKNOWN` Valeur : 0 La stratégie SAN est inconnue.
`VDS_SP_ONLINE` Valeur : 0x1 Tous les disques nouvellement découverts sont mis en ligne et en lecture-écriture.
`VDS_SP_OFFLINE_SHARED` Valeur : 0x2 Tous les disques nouvellement découverts qui ne résident pas sur un bus partagé sont mis en ligne et en lecture-écriture.
`VDS_SP_OFFLINE` Valeur : 0x3 Tous les disques nouvellement découverts restent hors connexion et en lecture seule.
`VDS_SP_OFFLINE_INTERNAL` Valeur : 0x4
`VDS_SP_MAX` Valeur : 0x5

Remarques

La stratégie SAN détermine si un disque nouvellement découvert est mis en ligne ou reste hors connexion, et s’il est en lecture/écriture ou en lecture seule. Lorsqu’un disque est hors connexion, la disposition du disque peut être lue, mais aucun périphérique de volume n’est exposé via Plug-and-Play (PnP). Cela signifie qu’aucun système de fichiers ne peut être monté sur le disque. Lorsqu’un disque est en ligne, un ou plusieurs périphériques de volume sont installés pour le disque.

Pour interroger la stratégie SAN actuelle, utilisez la méthode IVdsServiceSAN ::GetSANPolicy .

Pour définir la stratégie SAN, utilisez la méthode IVdsServiceSAN ::SetSANPolicy .

Cette énumération remplace la clé de Registre NoAutoMount , qui se trouve sous le chemin d’accès du Registre suivant :

HKEY_LOCAL_MACHINE\Système\Currentcontrolset\Services\Mountmgr\NoAutoMount

La valeur de cette clé est une valeur REG_DWORD définie sur 0x00000000 pour activer la fonctionnalité de montage automatique Windows ou une valeur différente de zéro pour la désactiver. Si la fonctionnalité de montage automatique est activée, Windows monte automatiquement le système de fichiers pour un nouveau volume de base lorsqu’il est ajouté au système, puis affecte une lettre de lecteur au volume. Dans les configurations réseau de la zone système, la désactivation du montage automatique empêche Windows de monter ou d’affecter automatiquement des lettres de lecteur à tous les nouveaux volumes de base ajoutés au système.

Sur Windows Server 2016, la stratégie SAN par défaut est VDS_SP_OFFLINE_SHARED. Cela s’applique à toutes les éditions et types d’installation, y compris Nano Server.

Sur Windows Server 2008 Entreprise et Windows Server 2008 Datacenter, la stratégie SAN par défaut est VDS_SP_OFFLINE_SHARED. Sur toutes les autres éditions de Windows Server 2008, la stratégie SAN par défaut est VDS_SP_ONLINE.

Pour une mise à niveau à partir d’une version antérieure de Windows, si la clé de Registre NoAutoMount a été définie avant la mise à niveau, la mise à niveau efface cette clé de Registre et définit la stratégie SAN sur VDS_SP_OFFLINE_SHARED. (La clé de Registre NoAutoMount est définie par défaut sur Windows Server 2008 Entreprise et Windows Server 2008 Datacenter.) Si la clé de Registre NoAutoMount n’a pas été définie avant la mise à niveau, la mise à niveau définit la stratégie SAN sur VDS_SP_ONLINE. En outre, la mise à niveau vérifie chaque disque pour déterminer si les volumes sur le disque sont en ligne ou hors connexion. Si un disque est en ligne avant la mise à niveau et a un ou plusieurs volumes en ligne, la mise à niveau met ce disque et tous ses volumes en ligne, quelle que soit la stratégie SAN ou que le disque réside sur un bus partagé. Par exemple, supposons qu’un disque en ligne avec deux volumes hors connexion et un volume en ligne réside sur un bus partagé et que la clé de Registre NoAutoMount soit définie avant la mise à niveau. Après la mise à niveau, la stratégie SAN sera VDS_SP_OFFLINE_SHARED, le disque sera mis en ligne et les trois volumes seront mis en ligne.

Pour une installation propre de Windows, la stratégie SAN détermine si un disque est en ligne ou hors connexion après l’installation de Windows.

Note Des constantes supplémentaires peuvent être ajoutées à l’énumération VDS_SAN_POLICY dans les versions ultérieures de Windows. Pour cette raison, votre application doit être conçue pour gérer correctement une constante d’énumération non reconnue VDS_SAN_POLICY .

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista avec SP1 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
En-tête	vds.h

Voir aussi

IVdsServiceSAN ::GetSANPolicy

IVdsServiceSAN ::SetSANPolicy

Partager via