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.
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.
Call the methods on IADsFileService to manage general file service information.
| 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. |