Método IMDSPStorage2::GetStorage (mswmdm.h)
El método GetStorage permite ir directamente a un objeto de almacenamiento desde un nombre de almacenamiento en lugar de enumerar todos los almacenamientos para encontrarlo.
Sintaxis
HRESULT GetStorage(
[in] LPCWSTR pszStorageName,
[out] IMDSPStorage **ppStorage
);
Parámetros
[in] pszStorageName
Puntero a una cadena terminada en null que contiene el nombre de almacenamiento.
[out] ppStorage
Puntero al objeto de almacenamiento especificado por pszStorageName o NULL si no se encontró dicho almacenamiento.
Valor devuelto
El método devuelve un valor HRESULT. Todos los métodos de interfaz de Windows Media Administrador de dispositivos pueden devolver cualquiera de las siguientes clases de códigos de error:
- Códigos de error COM estándar
- Códigos de error de Windows convertidos en valores HRESULT
- Códigos de error de windows Media Administrador de dispositivos
Comentarios
La interfaz IMDSPStorage2::GetStorage amplía la funcionalidad de IMDSPStorage.
IMDSPStorage2::GetStorage no admite caracteres comodín. No es recursivo, es decir, solo encontrará objetos de almacenamiento en el almacenamiento actual.
Si no se implementa este método, debe devolver E_NOTIMPL. (No debe devolver WMDM_E_NOT_SUPPORTED ni ningún otro código que indique que este método no está implementado). Esto garantizará que Windows Media Administrador de dispositivos intente sustituir esta funcionalidad mediante la enumeración de todos los almacenamientos para encontrar una coincidencia en función del nombre de almacenamiento pasado como pszStorageName.
Se recomienda encarecidamente que un proveedor de servicios implemente este método para devolver eficazmente un objeto de almacenamiento basado en el nombre.
Este método es opcional. Para obtener más información, consulte Interfaces obligatorias y opcionales.
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Windows |
| Encabezado | mswmdm.h |
| Library | Mssachlp.lib |