ICOMAdminCatalog2::CreateServiceForApplication 方法 (comadmin.h)
設定 COM+ 應用程式以 Windows 服務的形式執行。
語法
HRESULT CreateServiceForApplication(
[in] BSTR bstrApplicationIDOrName,
[in] BSTR bstrServiceName,
[in] BSTR bstrStartType,
[in] BSTR bstrErrorControl,
[in] BSTR bstrDependencies,
[in] BSTR bstrRunAs,
[in] BSTR bstrPassword,
[in] VARIANT_BOOL bDesktopOk
);
參數
[in] bstrApplicationIDOrName
應用程式的應用程式識別碼或名稱。
[in] bstrServiceName
應用程式的服務名稱。 此名稱是服務控制管理員 (SCM) 所使用的內部名稱,而不是顯示名稱。
[in] bstrStartType
啟動服務的時機。 有效的自變數是 CreateService 函式 dwStartType 參數的選項。 自變數必須以引號括住。 以下是有效的自變數:SERVICE_BOOT_START、SERVICE_SYSTEM_START、SERVICE_AUTO_START、SERVICE_DEMAND_START和SERVICE_DISABLED。
[in] bstrErrorControl
如果此服務在啟動期間無法啟動,則為錯誤的嚴重性。 如果發生失敗,錯誤會決定啟動程式所採取的動作。 有效的自變數是 CreateService 函式 dwErrorControl 參數的選項。 自變數必須以引號括住。 以下是有效的自變數:SERVICE_ERROR_IGNORE、SERVICE_ERROR_NORMAL、SERVICE_ERROR_SEVERE和SERVICE_ERROR_CRITICAL。
[in] bstrDependencies
服務的相依性清單。 字串有兩種可能的格式:標準以 Null 分隔、雙 Null 終止的字串 (與 CreateService) 所記載完全相同;或腳本易記的服務名稱清單,以 「分隔 (在服務名稱) 中具有無效字元。 rpcss 服務在此參數中是隱含的,不需要指定。
[in] bstrRunAs
執行此服務的用戶名稱。 如果此參數為 NULL,服務會以本機服務的形式執行。
[in] bstrPassword
系統用戶帳戶的密碼。 如果服務設定為以本機服務的形式執行,此參數必須是 NULL 。
[in] bDesktopOk
指出是否應該允許服務與桌面互動。 只有當服務標示為本地服務且必須是 FALSE 時,此參數才有效。
傳回值
這個方法可以傳回標準傳回值E_INVALIDARG、E_OUTOFMEMORY、E_UNEXPECTED、E_FAIL和S_OK。
備註
您可以使用 DeleteServiceForApplication 方法來移除此方法所建立的服務。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows XP [僅限傳統型應用程式] |
最低支援的伺服器 | Windows Server 2003 [僅限桌面應用程式] |
目標平台 | Windows |
標頭 | comadmin.h |