IADsService Property Methods

The methods of the IADsService interface read and write the properties described in this topic. For more information see Interface Property Methods.

Properties in Vtable Order

Property	Access	Method Prototype

Dependencies	R/W	HRESULT get_Dependencies ([out] VARIANT *pvServiceDepend); HRESULT put_Dependencies ([in] VARIANT vServiceDepend);
DisplayName	R/W	HRESULT get_DisplayName ([out] BSTR *pbstrDisplayName); HRESULT put_DisplayName ([in] BSTR bstrDisplayName);
ErrorControl	R/W	HRESULT get_ErrorControl ([out] LONG *plErrorControl); HRESULT put_ErrorControl ([in] LONG lErrorControl);
HostComputer	R/W	HRESULT get_HostComputer ([out] BSTR *pbstrHostComputer); HRESULT put_HostComputer ([in] BSTR bstrHostComputer);
LoadOrderGroup	R/W	HRESULT get_LoadOrderGroup ([out] BSTR *pbstrLoadOrderGroup); HRESULT put_LoadOrderGroup ([in] BSTR bstrLoadOrderGroup);
Path	R/W	HRESULT get_Path ([out] BSTR *pbstrPath); HRESULT put_Path ([in] BSTR bstrPath);
ServiceAccountName	R/W	HRESULT get_ServiceAccountName ([out] BSTR *pbstrServiceAccountName); HRESULT put_ServiceAccountName ([in] BSTR bstrServiceAccountName);
ServiceAccountPath	R/W	HRESULT get_ServiceAccountPath ([out] BSTR *pbstrServiceAccountPath); HRESULT put_ServiceAccountPath ([in] BSTR bstrServiceAccountPath);
ServiceType	R/W	HRESULT get_ServiceType ([out] LONG *plServiceType); HRESULT put_ServiceType ([in] LONG lServiceType);
StartType	R/W	HRESULT get_StartType ([out] LONG *plStartType); HRESULT put_StartType ([in] LONG lStartType);
StartupParameters	R/W	HRESULT get_StartupParameters ([out] BSTR *pbstrStartupParameters); HRESULT put_StartupParameters ([in] BSTR bstrStartupParameters);
Version	R/W	HRESULT get_Version ([out] BSTR *pbstrVersion); HRESULT put_Version ([in] BSTR bstrVersion);

Property Descriptions

Dependencies

Array of BSTR names of services or load groups that must be loaded in order for this service to load. The syntax for the entry is "Service:" followed by the service name or "Group:" followed by the load group name.

DisplayName

Gets and sets the friendly display name of the service.

ErrorControl

Gets and sets what action that should be taken if this service fails on startup. Valid values are:

ADS_SERVICE_ERROR_IGNORE	0x00000000
ADS_SERVICE_ERROR_NORMAL	0x00000001
ADS_SERVICE_ERROR_SEVERE	0x00000002
ADS_SERVICE_ERROR_CRITICAL	0x00000003

HostComputer

Gets and sets the ADsPath string of the host of this service.

LoadOrderGroup

Name of the load order group that this service is a member of.

Path

Path and filename to the executable of this service.

ServiceAccountName

Name of the account that this service uses to authenticate itself on startup.

ServiceType

Gets and sets the description of how a service manifests itself on the host computer. ServiceType is a bit mask that can contain the logical OR of the supported service type constant values. Valid values are:·

ADS_SERVICE_KERNEL_DRIVER	0x00000001
ADS_SERVICE_FILE_SYSTEM_DRIVER	0x00000002
ADS_SERVICE_OWN_PROCESS	0x00000010
ADS_SERVICE_SHARE_PROCESS	0x00000020

StartType

Gets and sets when this service starts. Valid values are defined by referencing the Win32 SERVICE_XXX constants and are as follows:

ADS_SERVICE_BOOT_START: SERVICE_BOOT_START
ADS_SERVICE_SYSTEM_START: SERVICE_SYSTEM_START
ADS_SERVICE_AUTO_START: SERVICE_AUTO_START
ADS_SERVICE_DEMAND_START: SERVICE_DEMAND_START
ADS_SERVICE_DISABLED: SERVICE_DISABLED

StartupParameters

Parameters passed to the service on startup.

Version

Gets and sets the version of the service.

Property	Access	Method Prototype

Status	R/O	HRESULT get_Status ([out] LONG *plStatus);

Property Descriptions

Status

The service status. Values can be:

ADS_SERVICE_STOPPED	0X00000001
ADS_SERVICE_START_PENDING	0X00000002
ADS_SERVICE_STOP_PENDING	0x00000003
ADS_SERVICE_STOP_RUNNING	0x00000004
ADS_SERVICE_CONTINUE_PENDING	0x00000005
ADS_SERVICE_PAUSE_PENDING	0x00000006
ADS_SERVICE_PAUSED	0x00000007
ADS_SERVICE_ERROR	0x00000008