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

Artículo
08/25/2023

El método FindStorage busca un almacenamiento con el identificador único persistente especificado. El identificador único persistente de un almacenamiento se describe mediante la propiedad g_wszWMDMPersistentUniqueID de ese almacenamiento.

Sintaxis

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

Parámetros

[in] findScope

Ámbito de la operación de búsqueda. Debe tener uno de los siguientes valores.

Valor	Descripción
WMDM_FIND_SCOPE_GLOBAL	Busque en todo el dispositivo.
WMDM_FIND_SCOPE_IMMEDIATE_CHILDREN	Busque solo en los elementos secundarios inmediatos del almacenamiento actual.

[in] pwszUniqueID

Identificador único persistente del almacenamiento.

[out] ppStorage

Puntero al almacenamiento devuelto especificado por el parámetro pwszUniqueID .

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 proveedor de servicios devuelve un identificador único persistente a través de la propiedad g_wszWMDMPersistentUniqueID del almacenamiento. Para un almacenamiento específico, el identificador único persistente proporcionado por el proveedor de servicios debe ser el mismo en diferentes sesiones de conexión de dispositivos.

La aplicación puede llamar a FindStorage con este identificador único persistente en un momento posterior. En respuesta, Windows Media Administrador de dispositivos llama a este método en el proveedor de servicios (SP).

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.

Windows Media Administrador de dispositivos llama a este método solo para los dispositivos registrados para habilitar la sincronización con Reproductor multimedia de Windows. Para obtener más información, consulte Habilitación de la sincronización con Reproductor multimedia de Windows.