Méthode IVdsService ::QueryUnallocatedDisks (vds.h)

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

Retourne un objet d’énumération contenant une liste des disques non alloués gérés par VDS.

Syntaxe

HRESULT QueryUnallocatedDisks(
  [out] IEnumVdsObject **ppEnum
);

Paramètres

[out] ppEnum

Adresse d’un pointeur d’interface IEnumVdsObject qui peut être utilisé pour énumérer les disques en tant qu’objets de disque. Pour plus d’informations, consultez Utilisation d’objets d’énumération. Les appelants doivent libérer l’interface et chacun des objets de disque lorsqu’ils ne sont plus nécessaires 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/valeur de retour	Description
S_OK	L’énumération a été retournée avec succès.
VDS_E_INITIALIZED_FAILED 0x80042401L	Échec de l’initialisation de VDS. Si une application appelle cette méthode avant la fin de l’initialisation du service, la méthode est bloquée jusqu’à la fin de l’initialisation. Si l’initialisation échoue, cette erreur est retournée.

Remarques

Un disque non alloué n’est revendiqué par aucun fournisseur. Il peut contenir ou non des informations de format de partition MBR ou GPT. Il s’agit souvent d’un disque non initialisé. Si le disque status est VDS_DS_ONLINE ou VDS_DS_OFFLINE, le disque est non alloué et non initialisé. Si elle est VDS_DS_UNKNOWN, VDS_DS_NOT_READY, VDS_DS_FAILED ou VDS_DS_MISSING, elle n’est pas allouée, mais le service VDS ne peut pas déterminer s’il est initialisé ou non, peut-être en raison de problèmes avec le disque.

Pour déterminer le status du disque, consultez le membre status de la structure VDS_DISK_PROP ou VDS_DISK_PROP2 du disque.

Si le disque status est VDS_DS_ONLINE, le disque peut être ajouté à un pack.

Si le disque status est VDS_DS_OFFLINE, essayez de mettre le disque en ligne en appelant IVdsDiskOnline ::Online. Si l’appel à la méthode Online réussit, le disque peut être ajouté à un pack. Si l’appel à Online échoue, le disque ne peut pas être utilisé.

Configuration requise

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

Voir aussi

IEnumVdsObject

IVdsService