Compartir a través de

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

  • Artículo

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

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

Consulte también

Interfaz IMDSPStorage

Interfaz IMDSPStorage2