Share via

IMLCore::QueryLocation (Compact 7)

  • Article

3/12/2014

This method queries a plug-in data source for media items that match the specified IMLQuery.

Syntax

HRESULT QueryLocation(
  MLDataSource datasource,
  MLQueryFlags flags,
  BSTR location,
  IMLQuery *pQuery,
  MLRange range,
  IMLSortOrder *sortOrder,
  IMLStoreMetadata *pStoreMetadataCallback
);

Parameters

  • datasource
    [in] MLDataSource structure that specifies the type of data source.
  • flags
    [in] MLQueryFlags structure that contains the query options.
  • location
    [in] Location of the plug-in data source to query.
  • pQuery
    [in] Pointer to the IMLQuery object that contains the query.
  • range
    [in] MLRange structure that specifies the range of results returned from a query.
  • sortOrder
    [in] Pointer to an IMLSortOrder object that specifies the sort order for the returned properties.
  • pStoreMetadataCallback
    [in] Pointer to the application implemented IMLStoreMetadata that is called back for each browsed item. This does not write to the Media Library.

Return Values

Returns the HRESULT values shown in the following table.

Return code Description

S_OK

The method was successful.

E_INVALIDARG

One or more parameters are invalid.

E_POINTER

A pointer parameter is invalid.

E_FAIL

The method was not successful.

E_OUTOFMEMORY

An out of memory error occurred.

Remarks

This method browses the data source for media items that match the query. The metadata for the matching media items is stored in the call to IMLStoreMetadata::StoreMetadata. Items in the Media Library are not updated by this call.

Requirements

Header

mlibdll.h,
mlibdll.idl

Library

mlibdll.lib

See Also

Reference

IMLCore