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 |
---|---|
|
Un objet avec l’identificateur et le type spécifiés est introuvable. |
|
É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 |