IWMPEvents3::StringCollectionChange method

The StringCollectionChange event occurs when a string collection changes.

Syntax

void StringCollectionChange(
  IDispatch                          *pdispStringCollection,
  WMPStringCollectionChangeEventType change,
  long                               lCollectionIndex
);

Parameters

pdispStringCollection

Pointer to the IDispatch interface that represents the string collection that changed. Call QueryInterface to retrieve a pointer to IWMPStringCollection.

change

WMPStringCollectionChangeEventType value indicating the type of change that occurred.

lCollectionIndex

The index of the string collection item that changed.

Return value

This method does not return a value.

Remarks

To receive StringCollectionChange events, you must obtain your string collection as follows:

  1. Call IWMPLibrary::get_mediaCollection to get an IWMPMediaCollection interface.
  2. Call the getAttributeStringCollection method of the interface you obtained in step 1.
If you obtain your IWMPMediaCollection interface by calling IWMPCore::get_mediaCollection, you will not receive StringCollectionChange events.

You can also handle this event through an IDispatch event sink by using the _WMPOCXEvents interface.

Windows Media Player 10 Mobile: This event is not supported.

Requirements

   
Minimum supported client Windows Media Player 11.
Target Platform Windows
Header wmp.h
DLL Wmp.dll

See also

IWMPEvents3 Interface

IWMPStringCollection Interface

_WMPOCXEvents Interface