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 版本。混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。如需詳細資訊，請參閱函式原型的慣例。