IWMSServer.FileDescriptions (Visual Basic .NET)

The FileDescriptions property retrieves an IWMSFileDescriptionsIWMSFileDescriptions Object (Visual Basic .NET) containing a collection of IWMSFileDescription objects that describe content files, playlist files, and directories.

IWMSFileDescriptions = IWMSServer.FileDescriptions(
  Path As String  Type As WMS_FILE_TYPE
)

Property Value

An IWMSFileDescriptions object.

If this property fails, it returns an error number.

Number

Description

0x00000002

The data source plug-in was not able to find the indicated file. This error is returned by the WMS File Data Source plug-in, but other plug-ins could return different error codes.

0x00000003

The path indicated by Path was not found.

0xC00D1580L

The data source plug-in that the server is attempting to use to access the path referenced by Path does not support the enumeration of files.

0xC00D157EL

The server was not able to find an enabled data source plug-in to access the indicated file.

Arguments

strPath

[in] String containing the file path name.

Type

[in] Member of the WMS_FILE_TYPE enumeration type. This must be one of the following values.

Value

Description

WMS_FILE_DIRECTORY

The item is a directory.

WMS_FILE_MEDIA

The item is a digital media file.

WMS_FILE_PLAYLIST

The item is a playlist.

WMS_FILE_STREAM_FORMAT

The item is a stream format file.

WMS_FILE_UNSPECIFIED

The file type is either unknown or unspecified.

Remarks

This property is read-only. You can only retrieve an IWMSFileDescriptions object for files that have registered media parsers or playlist parsers. The first parameter must start with an appropriate prefix to identify the type of storage system. For an NTFS or FAT file system, use the file:// prefix. For example, specifies the root directory of a server running on an NTFS or FAT file system and retrieves a collection of file://C:\asfrootIWMSFileDescription objects for the files and folders in that directory.

This method is not supported for cache proxy publishing points.

This method requires the Network Service account to have read and browse access to the specified path.

Example

Imports Microsoft.WindowsMediaServices.Interop
Imports System.Runtime.InteropServices

Private Sub GetFileDescriptions()

    ' Declare variables.
    Dim Server As WMSServer
    Dim FileDescriptions As IWMSFileDescriptions
    Dim strText As String

Try
    ' Create the WMSServer object.
    Server = New WMSServer()

    ' Retrieve a list of file descriptions for
    ' the specified path.
    strText = "c:\"
    FileDescriptions = Server.FileDescriptions(strText, WMS_FILE_TYPE.WMS_FILE_MEDIA)

Catch excCom As COMException
    ' TODO: Handle COM exceptions.
Catch exc As Exception
    ' TODO: Handle errors.
Finally
    ' TODO: Clean-up code goes here.
End Try

End Sub

Requirements

Reference: Add a reference to Microsoft.WindowsMediaServices.

Namespace: Microsoft.WindowsMediaServices.Interop.

Assembly: Microsoft.WindowsMediaServices.dll.

Library: WMSServerTypeLib.dll.

Platform: Windows ServerĀ 2003 family, Windows ServerĀ 2008 family.

See Also

Reference

IWMSFileDescription Object (Visual Basic .NET)

IWMSFileDescriptions Object (Visual Basic .NET)

IWMSServer Object (Visual Basic .NET)