Partager via


Méthode IVdsService ::GetObject (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 pointeur d’objet pour l’objet identifié.

Syntaxe

HRESULT GetObject(
  [in]  VDS_OBJECT_ID   ObjectId,
  [in]  VDS_OBJECT_TYPE type,
  [out] IUnknown        **ppObjectUnk
);

Paramètres

[in] ObjectId

GUID de l’objet souhaité.

[in] type

Valeur d’énumération VDS_OBJECT_TYPE qui spécifie le type d’objet. VDS_OT_UNKNOWN, VDS_OT_PROVIDER, VDS_OT_ASYNC, VDS_OT_ENUM et VDS_OT_OPEN_VDISK ne sont pas pris en charge.

[out] ppObjectUnk

Pointeur vers une mémoire tampon qui reçoit le pointeur IUnknown vers l’objet. Lorsque le pointeur n’est plus nécessaire, l’appelant doit le libérer 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
VDS_E_OBJECT_NOT_FOUND
0x80042405L
Un objet avec l’identificateur et le type spécifiés est introuvable.
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

Les notifications VDS retournent un identificateur d’objet au lieu d’un pointeur d’objet. Les appelants utilisent cette méthode pour obtenir un pointeur vers l’objet référencé dans la notification.

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

IVdsService

VDS_OBJECT_TYPE