IWMSPlaylistParser::WritePlaylist

  • Article

banner art

Previous Next

IWMSPlaylistParser::WritePlaylist

The WritePlaylist method writes the playlist files.

Syntax

Parameters

pPlaylist

[in] Pointer to an IXMLDOMDocument interface specifying the playlist file to write.

pCallback

[in] Pointer to an IWMSPlaylistParserCallback interface that is used by the plug-in to report to the server the result of the call to the WritePlaylist method.

qwContext

[in] QWORD containing a value defined by the server to identify which call to WritePlaylist the plug-in is responding to when it calls IWMSPlaylistParserCallback::OnWritePlaylist. You must pass this value back unaltered when you call OnWritePlaylist.

Return Values

If the method succeeds, the plug-in must return S_OK. To report an error, the plug-in can return any HRESULT other than S_OK. If the plug-in uses the IWMSEventLog interface to log error information directly to the Windows Event Viewer, it is recommended that it return NS_E_PLUGIN_ERROR_REPORTED. Typically, the server attempts to make plug-in error information available to the server object model, the Windows Event Viewer, and the troubleshooting list in the details pane of the Windows Media Services MMC. However, if the plug-in uses the IWMSEventLog interface to send custom error information to the Windows Event Viewer, returning NS_E_PLUGIN_ERROR_REPORTED stops the server from also logging to the event viewer. For more information about retrieving plug-in error information, see Identifying Plug-in Errors.

Remarks

This method is implemented by the plug-in and called by the server. The server calls the IWMSPlaylistParser::WritePlaylist method, if implemented, with a pointer to the result of the ReadPlaylist method call, which is an IXMLDOMDocument interface specifying the playlist file that is to be written. This method need only be called if you want the file saved.

Example Code

Requirements

Header: wmsplaylistparser.h.

Library: WMSServerTypeLib.dll.

Platform: Windows Server 2003, Enterprise Edition; Windows Server 2003, Datacenter Edition; Windows Server 2008.

See Also

Previous Next