IWMSLoggingAdmin Object (Visual Basic .NET)
Previous | Next |
IWMSLoggingAdmin Object (Visual Basic .NET)
The IWMSLoggingAdmin object is exposed by the WMS Client Logging plug-in, an event plug-in that listens for a log event and saves information gathered from that event to a log file. The logging plug-in can be installed in the namespace of both the server and a specific publishing point. Instances of the plug-in at the server level receive all notifications on all requested events. Instances of the plug-in at the publishing point level only receive events that are related to the specific publishing point.
The IWMSLoggingAdmin object exposes the following properties and methods.
Property | Description |
CurrentLogFileName | Retrieves the name of the current log file. |
Cycle | Retrieves an enumeration value indicating how often the log file cycles. |
Dirty | Retrieves a Boolean value indicating whether the currently running configuration is different from the stored configuration. |
FreeSpaceQuota | Specifies and retrieves the minimum amount of disk space that must remain after data has been written to a log file. |
LoggedEvents | Retrieves an enumeration value indicating the type of transmission for which events are logged. |
MaxSize | Retrieves the maximum permitted size of the log file. |
RoleFilter | Specifies a filter value for logging events with a specific role attribute. |
Template | Retrieves the log file template path. |
UseBuffering | Retrieves a Boolean value that indicates whether logging data is buffered before it is flushed to the log file. |
UseLocalTime | Specifies a Boolean value indicating whether local times are recorded in the log file. |
UseUnicode | Specifies a Boolean value indicating whether the log file contains Unicode or ANSI text. |
V4Compat | Specifies a Boolean value indicating whether log files are created in a format compatible with previous versions of Windows Media Services. |
Method | Description |
CycleNow | Forces a log file cycle. |
ExpandTemplate | Retrieves the expanded path of a template. |
Flush | Flushes the buffer to the log file. |
IsPathValid | Validates the path to the log file. |
Example Code
The following example illustrates how to retrieve an IWMSLoggingAdmin object.
Imports Microsoft.WindowsMediaServices.Interop Imports System.Runtime.InteropServices Private Sub RetrieveObj() ' Declare variables. Dim Server As WMSServer Dim Plugin As IWMSPlugin Dim LogAdmin As IWMSLoggingAdmin Try ' Create the WMSServer object. Server = New WMSServer() ' Retrieve the plug-in to be configured. Plugin = Server.EventHandlers.Item("WMS Client Logging") ' Retrieve the custom interface of the plug-in. LogAdmin = Plugin.CustomInterface 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
See Also
Previous | Next |