共用方式為

IADsService 屬性方法

  • 發行項

IADsService介面的屬性方法會讀取和寫入本主題中所述的屬性。 如需詳細資訊，請參閱 Interface 屬性方法。

屬性

Dependencies (相依性)

必須載入此服務才能載入的服務或載入群組 的 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
);

版本

服務的版本。

存取類型：讀取/寫入

腳本資料類型： 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

Interface 屬性方法