IWMSDataSourcePlugin.OpenDirectory (Visual Basic .NET)

  • Article

banner art

Previous Next

IWMSDataSourcePlugin.OpenDirectory (Visual Basic .NET)

The OpenDirectory method opens a directory data container.

Syntax

Parameters

pCommandContext

IWMSCommandContext object that specifies the request command context.

pUserContext

IWMSContext object that specifies the user context.

pPresentationContext

IWMSContext object that specifies the presentation context.

pszContainerName

String containing the directory name that the server resolved from the requested URL. This includes the scheme type, as in file://C:\wmpub\wmroot\.

dwFlags

UInt32 containing a member of the WMS_DATA_CONTAINER_OPEN_FLAGS enumeration type that indicates the type of access requested. This must be a bitwise OR of one or more of the following values.

Values Description
WMS_DATA_CONTAINER_READ_ACCESS The server has requested read access.
WMS_DATA_CONTAINER_WRITE_ACCESS The server has requested write access.
WMS_DATA_CONTAINER_CREATE_NEW_CONTAINER The server has requested that a new data container be created.
WMS_DATA_CONTAINER_ALLOW_BUFFER_IO Buffered data does not need to be page-aligned.

pBufferAllocator

IWMSBufferAllocator object that can be used by the data source plug-in to allocate additional buffers for reading or writing data.

pCallback

IWMSDataSourcePluginCallback object containing the callback function. The plug-in calls IWMSDataSourcePluginCallback.OnOpenDirectory to return the results to the server.

qwContext

UInt64 containing a value defined by the server to identify which OpenDirectory request the plug-in is responding to when it calls IWMSDataSourcePluginCallback.OnOpenDirectory. The plug-in must pass this value back unaltered.

Return Values

This method does not return a value. To report an error, the plug-in can throw a COMException object to the server. If the plug-in uses the IWMSEventLog object to log error information, it is recommended that it throw NS_E_PLUGIN_ERROR_REPORTED (0xC00D157D). 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 send custom error information to the Windows Event Viewer, throwing 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.

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; and Windows Server 2008.

See Also

Previous Next