IVdsVDisk ::Open, méthode (vds.h)

Article
03/03/2024

[À 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.]

Ouvre un handle vers le fichier de disque virtuel spécifié et retourne un pointeur d’interface IVdsOpenVDisk vers l’objet qui représente le handle ouvert.

Syntaxe

HRESULT Open(
  [in]  VIRTUAL_DISK_ACCESS_MASK AccessMask,
  [in]  OPEN_VIRTUAL_DISK_FLAG   Flags,
  [in]  ULONG                    ReadWriteDepth,
  [out] IVdsOpenVDisk            **ppOpenVDisk
);

Paramètres

[in] AccessMask

Masque de bits de VIRTUAL_DISK_ACCESS_MASK indicateurs spécifiant les droits d’accès à appliquer au disque virtuel ouvert.

[in] Flags

Masque de bits de OPEN_VIRTUAL_DISK_FLAG indicateurs spécifiant la façon dont le disque virtuel doit être ouvert.

[in] ReadWriteDepth

Nombre de magasins (fichiers de stockage), 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.)

[out] ppOpenVDisk

Pointeur vers une variable qui reçoit un pointeur d’interface IVdsOpenVDisk vers l’objet nouvellement créé qui représente le handle ouvert sur l’objet de disque virtuel. Les appelants doivent libérer le pointeur d’interface lorsqu’il n’est plus nécessaire en appelant la méthode IUnknown ::Release .

Valeur retournée

Cette méthode peut retourner des valeurs HRESULT standard, telles que E_INVALIDARG ou E_OUTOFMEMORY, et des valeurs de retour spécifiques à VDS. Il peut également retourner des codes d’erreur système convertis à l’aide de la macro HRESULT_FROM_WIN32 . Les erreurs peuvent provenir de VDS lui-même ou du fournisseur VDS sous-jacent utilisé. Les valeurs de retour possibles sont les suivantes.

Code de retour	Description
S_OK	La commande s'est correctement terminée.

Notes

Les applications doivent initialiser la sécurité à l’échelle du processus en appelant la fonction CoInitializeSecurity . Le paramètre dwImpLevel doit être défini sur RPC_C_IMP_LEVEL_IMPERSONATE.

Windows Server 2008, Windows Vista et Windows Server 2003 : Ces actions ne sont pas requises avant Windows 7 et Windows Server 2008 R2.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 7 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 R2 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	vds.h
Bibliothèque	Uuid.lib

Voir aussi

IVdsVDisk

Partager via