Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
The OnOpenDataContainer method is called by a data source plug-in to respond when the server calls IWMSDataSourcePlugin.OpenDataContainer.
void IWMSDataSourcePluginCallback.OnOpenDataContainer(
int hr,
IWMSDataContainer pDataContainer,
ulong qwContext
);
Arguments
int containing the result of the call to IWMSDataSourcePlugin.OpenDataContainer. |
|
IWMSDataContainerIWMSDataContainer Object (C#) identifying the data container opened by the plug-in. |
|
ulong containing a value defined by the server to identify which IWMSDataSourcePlugin.OpenDataContainer request the plug-in is responding to when it calls OnOpenDataContainer. The plug-in must pass this value back unaltered. |
Return Value
This method does not return a value. If the plug-in uses the IWMSEventLogIWMSEventLog Object (C#) to log error information, it is recommended that it send NS_E_PLUGIN_ERROR_REPORTED (0xC00D157D) to the server in the lHr parameter. 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 object to log custom error information to the Windows Event Viewer, sending NS_E_PLUGIN_ERROR_REPORTED stops the server from also logging to the event viewer. For more information about plug-in error information, see Identifying Plug-in Errors.
Remarks
If the server requests that the data container be used for a shared broadcast by sending WMS_DATA_CONTAINER_SHARED_SOURCE in the dwFlags parameter when it calls IWMSDataSourcePlugin.OpenDataContainer, and the plug-in determines that the source cannot be shared, the plug-in can return COMADMIN_E_PRIVATE_ACCESSDENIED to the server in the hr parameter of OnOpenDataContainer. The COMADMIN_E_PRIVATE_ACCESSDENIED error is defined in the WinError.h file. A plug-in can indicate that a source must not be shared if, for example, a distribution connection requires authentication or the content must be personalized for a specific end user. When the server receives this error, it deletes the shared data path and creates an on-demand (non-shared) data path instead.
Requirements
Reference: Add a reference to Microsoft.WindowsMediaServices.
Namespace: Microsoft.WindowsMediaServices.Interop.
Assembly: Microsoft.WindowsMediaServices.dll.
Library: WMSServerTypeLib.dll.
Platform: Windows Server 2003, Enterprise Edition; Windows Server 2003, Datacenter Edition; Windows Server 2008.