Partager via


Méthode IVdsController ::GetPortProperties (vdshwprv.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 les propriétés du port de contrôleur spécifié.

Syntaxe

HRESULT GetPortProperties(
  [in]  SHORT         sPortNumber,
  [out] VDS_PORT_PROP *pPortProp
);

Paramètres

[in] sPortNumber

Numéro du port. Les numéros de port sont permanents. Les ports sont numérotés à partir de 0.

[out] pPortProp

Adresse d’une structure de VDS_PORT_PROP allouée et transmise par l’appelant. VDS alloue de la mémoire pour les chaînes membres pwszFriendlyName et pwszIdentification . Les appelants doivent libérer les chaînes à l’aide de la fonction CoTaskMemFree .

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_PROVIDER_CACHE_CORRUPT
0x8004241FL
Cette valeur de retour signale un problème logiciel ou de communication à l’intérieur d’un fournisseur qui met en cache des informations sur le tableau. Utilisez la méthode IVdsHwProvider ::Reenumerate suivie de la méthode IVdsHwProvider ::Refresh pour restaurer le cache.
VDS_E_OBJECT_DELETED
0x8004240BL
L’objet contrôleur n’est plus présent.
VDS_E_NOT_SUPPORTED
0x80042400L
Cette opération ou cette combinaison de paramètres n’est pas prise en charge par ce fournisseur.

Remarques

Utilisez la méthode IVdsController ::GetProperties pour obtenir le nombre total de ports.

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 vdshwprv.h
Bibliothèque Uuid.lib

Voir aussi

IVdsController

IVdsController ::GetProperties

IVdsHwProvider ::Réenumerate

IVdsHwProvider ::Refresh

VDS_CONTROLLER_PROP

VDS_PORT_PROP