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

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 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 distintas 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.

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.

Este método permite buscar un almacenamiento basado en un identificador único persistente, mientras que IMDSPStorage2::GetStorage permite buscar un almacenamiento basado en el nombre.

Windows Media Administrador de dispositivos llama a este método solo para dispositivos que se pueden sincronizar con Reproductor multimedia de Windows. Consulte Habilitación de la sincronización con Reproductor multimedia de Windows para obtener más información.

Requisitos

Requisito	Value
Plataforma de destino	Windows
Encabezado	mswmdm.h
Library	Mssachlp.lib

Consulte también

Habilitación de la sincronización con Reproductor multimedia de Windows

IMDSPStorage2::GetStorage

Interfaz IMDSPStorage4