Metodo IWMDMStorage4::GetSpecifiedMetadata (mswmdm.h)

Articolo
03/05/2024

Il metodo GetSpecifiedMetadata recupera una o più proprietà di metadati specifiche dall'archiviazione.

Sintassi

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

Parametri

[in] cProperties

Conteggio delle proprietà da recuperare.

[in] ppwszPropNames

Matrice di nomi di proprietà da recuperare. La lunghezza di questa matrice deve essere uguale a cProperties. L'applicazione deve liberare questa memoria usando CoTaskMemFree.

[out] ppMetadata

Puntatore al puntatore dell'interfaccia IWMDMMetaData restituito, contenente i valori recuperati. Il chiamante deve rilasciare questa interfaccia al termine dell'operazione.

Valore restituito

Il metodo restituisce un valore HRESULT. Tutti i metodi di interfaccia in Windows Media Gestione dispositivi possono restituire una delle classi di codici di errore seguenti:

Codici di errore COM standard
Codici di errore di Windows convertiti in valori HRESULT
Codici di errore di Windows Media Gestione dispositivi

Per un elenco completo dei codici di errore possibili, vedere Codici di errore.

Commenti

Questo metodo fornisce al client il controllo su quali proprietà vengono recuperate. Può essere più efficiente di IWMDMStorage3::GetMetadata ed è consigliato quando il client necessita solo di un subset di proprietà supportate dall'archiviazione.

Se questo metodo viene usato per recuperare dati da un dispositivo WINDOWS Portable Devices (WPD), i dati vengono restituiti in formato binario in un oggetto IPortableDeviceValues . L'applicazione deve serializzare questi dati per ottenere i valori effettivi delle proprietà.

Il metodo ha esito positivo e restituisce WMDM_S_NOT_ALL_PROPERTIES_RETRIEVED anche se alcune delle proprietà specificate non sono state recuperate (ma almeno una proprietà è stata recuperata). Il metodo ha esito negativo e restituisce WMDM_E_NOTSUPPORTED se non è possibile recuperare nessuna delle proprietà specificate.

La richiesta di una singola proprietà è un caso speciale di questo metodo. Se il client richiede una singola proprietà, i codici restituiti possibili vengono S_OK, E_INVALIDARG e WMDM_E_NOTSUPPORTED. Pertanto, nel caso di una singola proprietà, il metodo ha esito positivo solo se la proprietà viene recuperata correttamente.