ILogScripting COM Interface
This section describes the ILogScripting interface, which is implemented by the IIS logging component, . The IIS logging component can be used from an administration script or ASP page to read and write IIS log files.
Note
The IIS logging component and the ILogScripting interface are deprecated. IIS 6.0 will be the last version that supports these features. For alternatives, see IIS Logging Overview.
If you want to create a custom component that implements the ILogScripting interface, you need to create an automation (IDispatch) object implementing the methods if the ILogScripting interface.
Your interface should be designed and implemented to handle only one log file query session per module instance. Therefore, each call to ILogScripting::SetInputLogFile and ILogScripting::SetInputServerInstance should reset the record read state.
.gif "Important note") Important Note: |
|---|
If you want a custom logging module to work with a component that implements ILogScripting, your custom logging module must provide support for automation data types and other basic automation features. |
Methods in Vtable Order
The ILogScripting interface inherits the methods of the standard COM interface IUnknown.
The following methods are defined by the ILogScripting interface, and allow the caller to control what log records your custom logging module is reading.
Method |
Description |
|---|---|
Closes all log files |
|
Reads the next available log record |
|
Sets the log file to be read |
|
Specifies which server's log files should be read |
|
Sets the log file to which log records should be written |
|
Writes a log record to the log file |
Once the caller has used the methods described above to gain access to a particular log record, the following methods should become functional. These methods, implemented by your custom logging module, enable the caller to retrieve specific types of information from the log record.
Method |
Description |
|---|---|
Retrieves the number of bytes received |
|
Retrieves the number of bytes sent |
|
Retrieves the client's host name |
|
Retrieves the user's name |
|
Retrieves the computer name |
|
Retrieves the custom fields |
|
Retrieves the date and time |
|
Retrieves the HTTP operation type |
|
Retrieves any parameters passed as part of the HTTP request |
|
Retrieves the port number |
|
Retrieves the HTTP protocol status code |
|
Retrieves the server's IP address |
|
Retrieves the service name and server instance |
|
Retrieves the target string for the HTTP request |
|
Retrieves the total processing time |
|
Retrieves the version string |
|
Retrieves the Win32 status code |
Requirements
Client: Requires Windows XP Professional, Windows 2000 Professional, or Windows NT Workstation 4.0.
Server: Requires Windows Server 2003, Windows 2000 Server, or Windows NT Server 4.0.
Product: IIS