共用方式為


OpenServiceA 函式 (winsvc.h)

開啟現有的服務。

語法

SC_HANDLE OpenServiceA(
  [in] SC_HANDLE hSCManager,
  [in] LPCSTR    lpServiceName,
  [in] DWORD     dwDesiredAccess
);

參數

[in] hSCManager

服務控制管理員資料庫的句柄。 OpenSCManager 函式會傳回此句柄。 如需詳細資訊,請參閱 服務安全性和訪問許可權

[in] lpServiceName

要開啟的服務名稱。 這是建立服務物件時,CreateService 函式的 lpServiceName 參數所指定的名稱,而不是由使用者介面應用程式所顯示的服務顯示名稱來識別服務。

字串長度上限為 256 個字元。 服務控制管理員資料庫會保留字元的大小寫,但服務名稱比較一律不區分大小寫。 正斜線 (/) 和反斜杠 (\) 無效的服務名稱字元。

[in] dwDesiredAccess

服務的存取權。 如需訪問許可權的清單,請參閱 服務安全性和訪問許可權

授與要求存取權之前,系統會根據與服務對象相關聯之安全性描述元的任意訪問控制清單,檢查呼叫程式的存取令牌。

傳回值

如果函式成功,則傳回值是服務的句柄。

如果函式失敗,則傳回值為 NULL。 若要取得擴充的錯誤資訊,請呼叫 GetLastError

服務控制管理員可以設定下列錯誤碼。 其他可由服務控制管理員呼叫的登錄函式設定。

傳回碼 Description
ERROR_ACCESS_DENIED
句柄沒有服務的存取權。
ERROR_INVALID_HANDLE
指定的句柄無效。
ERROR_INVALID_NAME
指定的服務名稱無效。
ERROR_SERVICE_DOES_NOT_EXIST
指定的服務不存在。

備註

傳回的句柄僅適用於呼叫 OpenService 的進程。 您可以呼叫 CloseServiceHandle 函式來關閉它。

若要使用 OpenService,除了 SC_MANAGER_CONNECT之外,不需要任何許可權。

範例

如需範例,請參閱 啟動服務

注意

winsvc.h 標頭會將 OpenService 定義為別名,根據 UNICODE 預處理器常數的定義,自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼,可能會導致編譯或運行時間錯誤不符。 如需詳細資訊,請參閱 函式原型的慣例

規格需求

需求
最低支援的用戶端 Windows XP [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 [僅限傳統型應用程式]
目標平台 Windows
標頭 winsvc.h (包括 Windows.h)
程式庫 Advapi32.lib
Dll Advapi32.dll

另請參閱

ChangeServiceConfig

CloseServiceHandle

ControlService

CreateService

DeleteService

EnumDependentServices

OpenSCManager

QueryServiceConfig

QueryServiceDynamicInformation

QueryServiceObjectSecurity

QueryServiceStatusEx

SCM 句柄

服務函式

SetServiceObjectSecurity

StartService