Share via

IMLCore::ScanLocation (Compact 7)

  • Article

3/12/2014

This method synchronizes the contents of a location on the data source with the Media Library.

Syntax

HRESULT ScanLocation(
  MLDataSource datasource,
  MLQueryFlags flags,
  BSTR location
);

Parameters

  • datasource
    [in] MLDataSource structure that specifies the type of data source plug-in.
  • flags
    [in] MLQueryFlags structure that contains the options that are used when the Media Library scans this location.
  • location
    [in] URL of the source data that you want to scan for updates.

Return Values

Returns the HRESULT values shown in the following table.

Value Description

S_OK

The method was successful.

E_INVALIDARG

One or more parameters are invalid.

E_FAIL

The method was not successful.

E_MEMORY

An out of memory error occurred.

Remarks

This method performs a single update to the Media library for the specified location. It does not add the location to the watch list. To add a location to the watch list, call IMLPushQueue::AddWatchedLocation.

When a location is scanned, new files are added to the Media Library, modified files are scanned and updated, and deleted files are marked as "is_deleted" but they are not removed physically from the Media Library.

Requirements

Header

mlibdll.h,
mlibdll.idl

Library

mlibdll.lib

See Also

Reference

IMLCore