MÉTHODE IMDSPStorage2 ::GetStorage (mswmdm.h)
La méthode GetStorage permet d’accéder directement à un objet de stockage à partir d’un nom de stockage 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 de stockage.
[out] ppStorage
Pointeur vers l’objet de stockage spécifié par pszStorageName ou NULL si aucun stockage de ce type n’a été trouvé.
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 de codes d’erreur suivantes :
- Codes d’erreur COM standard
- Codes d’erreur Windows convertis en valeurs HRESULT
- Codes d’erreur Gestionnaire de périphériques Windows Media
Remarques
L’interface IMDSPStorage2 ::GetStorage étend les fonctionnalités d’IMDSPStorage.
IMDSPStorage2 ::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 objets de stockage dans le stockage actuel.
Si cette méthode n’est pas implémentée, elle doit retourner E_NOTIMPL. (Il ne doit pas retourner WMDM_E_NOT_SUPPORTED ou tout autre code 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 en fonction du nom de stockage transmis 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 en fonction du nom.
Cette méthode est facultative. Pour plus d’informations, consultez Interfaces obligatoires et facultatives.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Windows |
| En-tête | mswmdm.h |
| Bibliothèque | Mssachlp.lib |