MÉTHODE IMDSPDevice2 ::GetStorage (mswmdm.h)

La méthode GetStorage permet d’accéder directement à un stockage en fonction de son nom au lieu d’énumérer tous les stockages pour le trouver.

Syntaxe

HRESULT GetStorage(
  [in]  LPCWSTR      pszStorageName,
  [out] IMDSPStorage **ppStorage
);

Paramètres

[in] pszStorageName

Pointeur vers une chaîne terminée par null contenant le nom du stockage à rechercher.

[out] ppStorage

Pointeur vers l’objet de stockage spécifié par le paramètre pszStorageName .

Valeur retournée

Cette méthode retourne un code HRESULT. Toutes les méthodes d’interface dans Windows Media Gestionnaire de périphériques peuvent retourner l’une des classes suivantes de codes d’erreur :

• Codes d’erreur COM standard
• Codes d’erreur Windows convertis en valeurs HRESULT
• Codes d’erreur Gestionnaire de périphériques Windows Media

Remarques

La méthode GetStorage ne prend pas en charge les caractères génériques. Il n’est pas récursif, c’est-à-dire qu’il ne trouvera que des stockages à la racine de l’appareil.

Si cette méthode n’est pas implémentée, elle doit retourner E_NOTIMPL. (Elle ne doit pas retourner WMDM_E_NOT_SUPPORTED ou d’autres codes indiquant que cette méthode n’est pas implémentée). Cela garantit que Windows Media Gestionnaire de périphériques tentera de remplacer cette fonctionnalité en énumérant tous les stockages pour trouver une correspondance basée sur le nom de stockage passé en tant que pszStorageName.

Il est vivement recommandé qu’un fournisseur de services implémente cette méthode pour retourner efficacement un objet de stockage basé sur son nom.

Cette méthode est facultative. Pour plus d’informations, consultez Interfaces obligatoires et facultatives.

Configuration requise

Voir aussi

IMDSPDevice2 Interface