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

Artículo
08/25/2023

El método FindStorage recupera un almacenamiento en el almacenamiento raíz actual, en función de su identificador único persistente.

Sintaxis

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

Parámetros

[in] findScope

Enumeración de WMDM_FIND_SCOPE que especifica el ámbito que se va a buscar.

[in] pwszUniqueID

Identificador único persistente del almacenamiento que se va a encontrar. El identificador único persistente del almacenamiento se describe mediante la propiedad de metadatos g_wszWMDMPersistentUniqueID del almacenamiento.

[out] ppStorage

Puntero al almacenamiento recuperado, si se encuentra. 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

Este método solo busca en un solo objeto de memoria (tarjeta flash o disco duro) en el dispositivo.

Un identificador único persistente identifica 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. Del mismo modo, el contenido diferente puede tener el mismo identificador único persistente cuando se almacena en diferentes dispositivos.

El formato del identificador único persistente depende del dispositivo. La aplicación debe haber obtenido el identificador único persistente anteriormente mediante la obtención de un almacenamiento y consultarlo para su propiedad WMDM/PersistentUniqueID . Use los métodos GetSpecifiedMetadata o GetMetadata para solicitar esta propiedad.