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。

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

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

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

如需範例，請參閱啟動服務。

注意

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