通过

IADsService 属性方法

  • 项目

IADsService 接口的属性方法读取和写入本主题中所述的属性。 有关详细信息，请参阅 接口属性方法。

属性

依赖项

服务或加载组的 BSTR 名称数组，必须加载这些名称才能加载此服务。 条目的语法是“Service：”，后跟服务名称或“Group：”，后跟加载组名称。

访问类型：读/写

脚本数据类型： VARIANT

// C++ method syntax
HRESULT get_Dependencies(
  [out] VARIANT* pvServiceDepend
);
HRESULT put_Dependencies(
  [in] VARIANT vServiceDepend
);

DisplayName

服务的友好名称。

访问类型：读/写

脚本数据类型： BSTR

// C++ method syntax
HRESULT get_DisplayName(
  [out] BSTR* pbstrDisplayName
);
HRESULT put_DisplayName(
  [in] BSTR bstrDisplayName
);

ErrorControl

此服务在启动时失败时要执行的操作。 下面是此属性的有效值。

ADS_SERVICE_ERROR_IGNORE

启动程序记录错误，但继续启动操作。

ADS_SERVICE_ERROR_NORMAL

启动程序记录错误并显示一个消息框，但会继续启动操作。

ADS_SERVICE_ERROR_SEVERE

启动程序记录错误。 如果启动最后一个已知良好的配置，则启动操作将继续。 否则，系统会使用上次已知良好的配置重启系统。

ADS_SERVICE_ERROR_CRITICAL

如果可能，启动程序会记录错误。 如果最近一次的正确配置正在启动，则启动操作会失败。 否则，系统会使用上次已知的良好配置重启系统。

访问类型：读/写

脚本数据类型： LONG

// C++ method syntax
HRESULT get_ErrorControl(
  [out] LONG* plErrorControl
);
HRESULT put_ErrorControl(
  [in] LONG lErrorControl
);

HostComputer

此服务的主机的 ADsPath 字符串。

访问类型：读/写

脚本数据类型： BSTR

// C++ method syntax
HRESULT get_HostComputer(
  [out] BSTR* pbstrHostComputer
);
HRESULT put_HostComputer(
  [in] BSTR bstrHostComputer
);

LoadOrderGroup

此服务所属的加载顺序组的名称。

访问类型：读/写

脚本数据类型： BSTR

// C++ method syntax
HRESULT get_LoadOrderGroup(
  [out] BSTR* pbstrLoadOrderGroup
);
HRESULT put_LoadOrderGroup(
  [in] BSTR bstrLoadOrderGroup
);

路径

此服务的可执行文件的路径和文件名。

访问类型：读/写

脚本数据类型： BSTR

// C++ method syntax
HRESULT get_Path(
  [out] BSTR* pbstrPath
);
HRESULT put_Path(
  [in] BSTR bstrPath
);

ServiceAccountName

此服务在启动时用于对自身进行身份验证的帐户的名称。

访问类型：读/写

脚本数据类型： BSTR

// C++ method syntax
HRESULT get_ServiceAccountName(
  [out] BSTR* pbstrServiceAccountName
);
HRESULT put_ServiceAccountName(
  [in] BSTR bstrServiceAccountName
);

ServiceAccountPath

ServiceAccountPath 属性指定的帐户的路径。

访问类型：读/写

脚本数据类型： BSTR

// C++ method syntax
HRESULT get_ServiceAccountPath(
  [out] BSTR* pbstrServiceAccountPath
);
HRESULT put_ServiceAccountPath(
  [in] BSTR bstrServiceAccountPath
);

ServiceType

服务如何在主计算机上呈现自己的说明。 此属性可以是零，也可以是以下一个或多个值的组合。

ADS_SERVICE_KERNEL_DRIVER (0x00000001)

ADS_SERVICE_FILE_SYSTEM_DRIVER (0x00000002)

ADS_SERVICE_OWN_PROCESS (0x00000010)

ADS_SERVICE_SHARE_PROCESS (0x00000020)

访问类型：读/写

脚本数据类型： LONG

// C++ method syntax
HRESULT get_ServiceType(
  [out] LONG* plServiceType
);
HRESULT put_ServiceType(
  [in] LONG lServiceType
);

StartType

确定如何启动服务。 下面是此属性的有效值。

ADS_SERVICE_BOOT_START

该服务是由系统加载程序启动的设备驱动程序。 此值只对驱动程序服务有效。

ADS_SERVICE_SYSTEM_START

该服务是由 IoInitSystem 函数启动的设备驱动程序。 此值只对驱动程序服务有效。

ADS_SERVICE_AUTO_START

服务控制管理器将在系统启动期间自动启动该服务。

ADS_SERVICE_DEMAND_START

当进程调用 StartService 函数时，服务控制管理器将启动该服务。

ADS_SERVICE_DISABLED

服务无法启动。 尝试启动服务会导致错误代码 ERROR_SERVICE_DISABLED。

访问类型：读/写

脚本数据类型： LONG

// C++ method syntax
HRESULT get_StartType(
  [out] LONG* plStartType
);
HRESULT put_StartType(
  [in] LONG lStartType
);

StartupParameters

启动时传递给服务的参数。

访问类型：读/写

脚本数据类型： BSTR

// C++ method syntax
HRESULT get_StartupParameters(
  [out] BSTR* pbstrStartupParameters
);
HRESULT put_StartupParameters(
  [in] BSTR bstrStartupParameters
);

Version

服务的版本。

访问类型：读/写

脚本数据类型： BSTR

// C++ method syntax
HRESULT get_Version(
  [out] BSTR* pbstrVersion
);
HRESULT put_Version(
  [in] BSTR bstrVersion
);

示例

下面的代码示例演示如何列出在主计算机上运行的所有可用系统服务“myMachine”，以及查找服务可执行文件的位置。

Dim cp As IADsComputer
On Error GoTo Cleanup

Set cp = GetObject("WinNT://myMachine,computer")
If (IsEmpty(cp) = False) Then
    cp.Filter = Array("Service")
    For Each service In cp
        MsgBox service.Name & " @" & service.path
    Next
End if

Cleanup:
    If (Err.Number<>0) Then
        MsgBox("An error has occurred. " & Err.Number)
    End If
    Set cp = Nothing

要求

要求 值
最低受支持的客户端
 Windows Vista
最低受支持的服务器
 Windows Server 2008
标头
Iads.h
DLL
Activeds.dll
IID
 IID_IADsService定义为 68AF66E0-31CA-11CF-A98A-00AA006BC149

另请参阅

IADsService

接口属性方法