Método IWMDMDevice3::FindStorage (mswmdm.h)

Artículo
08/25/2023

El método FindStorage busca un almacenamiento por su identificador único persistente. A diferencia de otros métodos, este método puede buscar de forma recursiva desde el almacenamiento raíz.

Sintaxis

HRESULT FindStorage(
  [in]  WMDM_FIND_SCOPE findScope,
  [in]  LPCWSTR         pwszUniqueID,
  [out] IWMDMStorage    **ppStorage
);

Parámetros

[in] findScope

Enumeración WMDM_FIND_SCOPE que especifica el ámbito de la operación de búsqueda.

[in] pwszUniqueID

Cadena de caracteres anchos terminada en null que representa un identificador único persistente del almacenamiento, que se puede recuperar consultando la propiedad g_wszWMDMPersistentUniqueID del almacenamiento.

[out] ppStorage

Puntero al almacenamiento devuelto. El autor de la llamada debe liberar esta interfaz cuando haya terminado con ella.

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

Un identificador único persistente se usa para identificar de forma única el contenido almacenado en un dispositivo determinado. No representa un identificador único global específico del contenido que permanece idéntico en todos los dispositivos. Por lo tanto, el mismo contenido almacenado en diferentes almacenamientos tendrá distintos identificadores únicos persistentes. De forma similar, el contenido diferente puede tener el mismo identificador único persistente cuando se almacena en diferentes dispositivos. El uso de la analogía del contenido en un dispositivo es similar a las filas de una base de datos, esta propiedad tiene el mismo propósito que la columna de identidad que sirve en una base de datos.

Dado que el dispositivo lo genera, el formato del identificador único persistente depende del dispositivo. La aplicación debe obtener el identificador único persistente consultando la propiedad g_wszWMDMPersistentUniqueID del almacenamiento. Una aplicación puede usar los métodos GetSpecifiedMetadata o GetMetadata para consultar esta propiedad.