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

Artículo
03/15/2023

El método GetSpecifiedMetadata recupera una o varias propiedades de metadatos específicas del almacenamiento.

Sintaxis

HRESULT GetSpecifiedMetadata(
  [in]  DWORD         cProperties,
  [in]  LPCWSTR       *ppwszPropNames,
  [out] IWMDMMetaData **ppMetadata
);

Parámetros

[in] cProperties

Recuento de propiedades que se van a recuperar.

[in] ppwszPropNames

Matriz de nombres de propiedad que se van a recuperar. La longitud de esta matriz debe ser igual a cProperties. La aplicación debe liberar esta memoria mediante CoTaskMemFree.

[out] ppMetadata

Puntero al puntero de interfaz IWMDMMetaData devuelto, que contiene los valores recuperados. El autor de la llamada debe liberar esta interfaz cuando termine 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 proporciona al cliente control sobre qué propiedades se recuperan. Esto puede ser más eficaz que IWMDMStorage3::GetMetadata y se recomienda cuando el cliente solo necesita un subconjunto de propiedades compatibles con el almacenamiento.

Si este método se usa para recuperar datos de un dispositivo Windows Portable Devices (WPD), los datos se devuelven en formato binario en un objeto IPortableDeviceValues . La aplicación debe des serializar estos datos para obtener los valores de propiedad reales.

El método se realiza correctamente y devuelve WMDM_S_NOT_ALL_PROPERTIES_RETRIEVED incluso si no se pudieron recuperar algunas de las propiedades especificadas (pero se recuperó al menos una propiedad). El método produce un error y devuelve WMDM_E_NOTSUPPORTED si no se puede recuperar ninguna de las propiedades especificadas.

La solicitud de una sola propiedad es un caso especial de este método. Si el cliente solicita una sola propiedad, los posibles códigos de retorno se S_OK, E_INVALIDARG y WMDM_E_NOTSUPPORTED. Por lo tanto, en el caso de una sola propiedad, el método solo se realiza correctamente si la propiedad se recupera correctamente.