Platform SDK: Active Directory, ADSI, and Directory Services

IADsFileServiceOperations

The IADsFileServiceOperations interface extends the functionality, as exposed in the IADsServiceOperations interface, for managing the file service across a network. Specifically, it serves to maintain and manage open resources and active sessions of the file service.

To bind to a file service operations object, you must use the ADsPath string identifying the "LanmanServer" service on the host computer, as shown in the following code snippet:

Dim fso As IADsFileServiceOperations
Set fso = GetObject("WinNT://aServer/aComputer/LanmanServer")

From this point on, you can treat the file service object as just a service object, applying any of the methods of IADsServiceOperations to the file service object. For example, you can examine the operational status of the file service, start or stop the file service, or change its password.

However, the IADsFileServiceOperations interface allows you to work with open resources and active sessions of the file service. For example,

For Each r in fso.Resources
MsgBox r.User
MsgBox r.Path
MsgBox r.LockCount
Next

For more information on active sessions and open resources, see IADsSession and IADsResource.

IADsFileServiceOperations is a dual interface that inherits from IADsServiceOperations. The IADsFileServiceOperations interface exposes the following methods.

Methods in Vtable Order

IUnknown methods Description
QueryInterface Returns pointers to supported interfaces.
AddRef Increments reference count.
Release Decrements reference count.

IDispatch methods Description
GetTypeInfoCount Gets the number of type descriptions.
GetTypeInfo Gets a description of object's programmable interface.
GetIDsOfNames Maps name of method or property to DISPID.
Invoke Calls one of the object's methods, or gets and sets one of its properties.

IADsFileServiceOperations methods Description
Sessions Gets an interface pointer on a collection object that represents current open sessions on this file service.
Resources Gets an interface pointer on a collection object that represents current open resources for this file service.

Requirements

  Windows NT/2000: Requires Windows 2000 (or Windows NT 4.0 with DSClient).
  Windows 95/98: Requires Windows 95 or later (with DSClient).
  Header: Declared in Iads.h.

See Also

IADsFileService, IADsResource, IADsService, IADsServiceOperations, IADsSession