IADsFileService

The IADsFileService interface enables a COM object in Active Directory to manage the information describing a software file service provided by a specific computer. Use IADsFileServiceOperations to retrieve interface pointers to the collections of active sessions or open resources used by a file service. IADsService and IADsServiceOperations manage information and provide controls over a network for a software service that is not a file service.

Properties accessed by IADsFileService are defined on an ADSI Service Object that represents a file service.

When to Implement

Implement IADsFileService only when you are providing an Active Directory implementation for a directory service that publishes the availability of file services on a network. If your directory service does not support this functionality, return E_NOTIMPL for this interface.

Under the Windows NT implementation, this interface is implemented on WinNTService.

When to Use

Call the methods on IADsFileService to manage general file service information.

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/sets one of its properties.

IADs Properties and Methods Description
get_Name Gets the object's relative name.
get_Class Gets the object's schema class name.
get_GUID Gets the object's globally unique identifier.
get_ADsPath Gets the object's ADsPath that uniquely identifies this object from all others.
get_Parent Gets the object's ADsPath string for its parent container.
get_Schema Gets the ADsPath string to the schema class definition object for this object.
GetInfo Reloads the changes on this object and its dependents.
SetInfo Saves the changes on this object and its dependents.
Get Gets the value for a property by name.
Put Sets the value for a property by name.
GetEx Gets the value for a single or multi-valued property by name.
PutEx Sets the value for a single or multi-valued property by name.
GetInfoEx Reloads specific property values for this object as they exist in the underlying directory service.

IADsService Properties and Methods Description
get/put_HostComputer Host of this service.
get/put_DisplayName Display name of this service.
get/put_Version Version of this service.
get/put_ServiceType Process type in which this service runs.
get/put_StartType At what time this service starts.
get/put_Path Path and filename of executable.
get/put_StartupParameters Parameters passed on start-up.
get/put_ErrorControl Actions for service failure.
get/put_LoadOrderGroup The load order group for this service.
get/put_ServiceAccountName Authentication account name.
get/put_ServiceAccountPath Path to user object for authentication.
get/put_Dependencies Other load groups or services this service needs.

IADsFileService Methods Description
get/put_Description Description of the file service.
get/put_MaxUserCount Maximum number of users allowed to run service concurrently.