structure OPEN_VIRTUAL_DISK_PARAMETERS (virtdisk.h)

Contient les paramètres de demande d’ouverture de disque virtuel.

Syntaxe

typedef struct _OPEN_VIRTUAL_DISK_PARAMETERS {
  OPEN_VIRTUAL_DISK_VERSION Version;
  union {
    struct {
      ULONG RWDepth;
    } Version1;
    struct {
      BOOL GetInfoOnly;
      BOOL ReadOnly;
      GUID ResiliencyGuid;
    } Version2;
  };
} OPEN_VIRTUAL_DISK_PARAMETERS, *POPEN_VIRTUAL_DISK_PARAMETERS;

Membres

Version

Énumération OPEN_VIRTUAL_DISK_VERSION qui spécifie la version de la structure OPEN_VIRTUAL_DISK_PARAMETERS transmise aux fonctions de disque dur virtuel.

Valeur	Signification
OPEN_VIRTUAL_DISK_VERSION_1 1	Utilisez le membre Version1 de cette structure.
OPEN_VIRTUAL_DISK_VERSION_2 2	Utilisez le membre Version2 de cette structure.

Version1

Cette structure est utilisée si le membre Version est OPEN_VIRTUAL_DISK_VERSION_1 (1).

Version1.RWDepth

Indique le nombre de magasins, en commençant par l’enfant, de la chaîne de magasins de stockage à ouvrir en lecture/écriture. Les magasins restants de la chaîne de différenciation sont ouverts en lecture seule. Cela est nécessaire pour que les opérations de fusion réussissent.

Valeur	Signification
0	Ne pas ouvrir pour lecture/écriture à n’importe quelle profondeur. Cette valeur doit être utilisée pour les opérations en lecture seule.
OPEN_VIRTUAL_DISK_RW_DEPTH_DEFAULT 1	Valeur par défaut à utiliser si aucune autre valeur n’est souhaitée.
n (défini par l’utilisateur)	Cette valeur entière doit être le nombre de niveaux de fusion plus un, si une opération de fusion est prévue.

Version2

Cette structure est utilisée si le membre Version est OPEN_VIRTUAL_DISK_VERSION_2 (2).

Windows 7 et Windows Server 2008 R2 : Cette structure n’est pas prise en charge tant qu’Windows 8 et Windows Server 2012.

Version2.GetInfoOnly

Si la valeur est TRUE, indique que le handle doit uniquement être utilisé pour obtenir des informations sur le disque virtuel.

Version2.ReadOnly

Si la valeur est TRUE, indique que le magasin de stockage de fichiers doit être ouvert en lecture seule.

Version2.ResiliencyGuid

GUID de résilience à spécifier lors de l’ouverture de fichiers.

Notes

Les paramètres suivants, préfacés version3, sont destinés à une utilisation interne.

Version3

Version3.GetInfoOnly

Version3.ReadOnly

Version3.ResiliencyGuid

Version3.SnapshotId

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 7
Serveur minimal pris en charge	Windows Server 2008 R2
En-tête	virtdisk.h

Voir aussi

À propos du disque dur virtuel

OpenVirtualDisk

Référence du disque dur virtuel