Compartir a través de

Método IMDSPDevice2::GetStorage (mswmdm.h)

  • Artículo

El método GetStorage permite ir directamente a un almacenamiento en función de su nombre en lugar de enumerar a través de 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 del almacenamiento que se va a buscar.

[out] ppStorage

Puntero al objeto de almacenamiento especificado por el parámetro pszStorageName .

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
Para obtener una lista extensa de posibles códigos de error, consulte Códigos de error.

Comentarios

El método GetStorage no admite caracteres comodín. No es recursivo, es decir, solo encontrará almacenamientos en la raíz del dispositivo.

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 por sí misma 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

Consulte también

Interfaz IMDSPDevice2