Método IWMDMStorage4::GetSpecifiedMetadata (mswmdm.h)
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
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.
Requisitos
Requisito | Value |
---|---|
Plataforma de destino | Windows |
Encabezado | mswmdm.h |
Library | Mssachlp.lib |