Share via


IMLMediaParser::ExtractMetadata (Compact 7)

3/12/2014

This method extracts the metadata from the media file, such as the music title or author, in the specified file.

Syntax

HRESULT ExtractMetadata(
    MLDSItem file,
    IMLPropertySet *pPropertySetWanted,
    IMLPropertySet *pFileMetadata
);

Parameters

  • file
    [in] A structure of type MLDSItem that contains the file information.
  • pPropertySetWanted
    [in] Pointer to the IMLPropertySet interface that lists the desired properties. Can be NULL to request all properties.
  • pFileMetadata
    [in] Pointer to the IMLPropertySet interface that will hold the parsed properties.

Return Values

Returns an HRESULT value. Possible values include the following.

Return code Description

S_OK

The method was successful.

E_INVALIDARG

One or more parameters are invalid.

E_POINTER

The pPropertySetWanted or the pFileMetadata parameter is invalid.

E_FAIL

The method was not successful.

E_OUTOFMEMORY

An out-of-memory error occurred.

Remarks

The Media Library determines which media parser object to call for each request and internally calls this method to extract the metadata.

Requirements

Header

mlibdll_plugin.h,
mlibdll_plugin.idl

Library

mlibdll.lib

See Also

Reference

IMLMediaParser