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

El método GetSpecifiedMetadata recupera solo el objeto de metadatos especificado para un almacenamiento.

Sintaxis

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

Parámetros

[in] cProperties

Recuento de propiedades que se van a recuperar.

[in] ppwszPropNames

Matriz que contiene los nombres de propiedad que se van a recuperar. El tamaño de esta matriz debe ser igual a cProperties.

[out] pMetadata

Puntero al puntero de interfaz IWMDMMetaData devuelto.

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 el control sobre qué propiedades se recuperan. El cliente puede especificar los nombres de propiedad de las propiedades que el cliente necesita recuperar.

En cambio, el método GetMetadata recupera todos los metadatos de almacenamiento (propiedades).

Si no se puede devolver ninguna de las propiedades especificadas, el proveedor de servicios debe devolver WMDM_E_NOTSUPPORTED o cualquier código de error adecuado.

Si se puede recuperar al menos una propiedad, el proveedor de servicios debe devolver esa propiedad y establecer el código de retorno en un código correcto de WMDM_S_NOT_ALL_PROPERTIES_RETRIEVED.

Requisitos

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

Consulte también

Interfaz IMDSPStorage4