openSCManagerA 函式 (winsvc.h)

發行項
03/04/2024

在指定的計算機上建立與服務控制管理員的連接，並開啟指定的服務控制管理員資料庫。

語法

SC_HANDLE OpenSCManagerA(
  [in, optional] LPCSTR lpMachineName,
  [in, optional] LPCSTR lpDatabaseName,
  [in]           DWORD  dwDesiredAccess
);

參數

[in, optional] lpMachineName

目標電腦的名稱。如果指標為 NULL 或指向空字串，則函式會連接到本機電腦上的服務控制管理員。

[in, optional] lpDatabaseName

服務控制管理員資料庫的名稱。此參數應該設定為 SERVICES_ACTIVE_DATABASE。如果是 NULL，預設會開啟SERVICES_ACTIVE_DATABASE資料庫。

[in] dwDesiredAccess

服務控制管理員的存取權。如需訪問許可權的清單，請參閱服務安全性和訪問許可權。

授與所要求的訪問許可權之前，系統會根據與服務控制管理員相關聯之安全描述項的任意訪問控制清單，檢查呼叫程式的存取令牌。

呼叫此函式會隱含指定SC_MANAGER_CONNECT訪問許可權。

傳回值

如果函式成功，傳回值就是指定之服務控制管理員資料庫的句柄。

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

SCM 可以設定下列錯誤碼。 SCM 所呼叫的登錄函式可以設定其他錯誤碼。

傳回碼	Description
ERROR_ACCESS_DENIED	要求的存取遭到拒絕。
ERROR_DATABASE_DOES_NOT_EXIST	指定的資料庫不存在。

備註

當行程使用 OpenSCManager 函式開啟服務控制管理員資料庫的句柄時，系統會在授與要求的存取權之前執行安全性檢查。如需詳細資訊，請參閱服務安全性和訪問許可權。

如果目前的使用者在連接到另一部計算機上的服務時沒有適當的存取權， OpenSCManager 函數調用就會失敗。若要從遠端連線到服務，請使用 LOGON32_LOGON_NEW_CREDENTIALS呼叫 LogonUser 函式，然後在呼叫 OpenSCManager 之前呼叫 ImpersonateLoggedOnUser。如需遠端連線到服務的詳細資訊，請參閱服務和 RPC/TCP。

只有具有系統管理員許可權的進程才能開啟 CreateService 函式可以使用的資料庫句柄。

傳回的句柄只適用於呼叫 OpenSCManager 函式的進程。您可以藉由呼叫 CloseServiceHandle 函式來關閉它。

範例

如需範例，請參閱變更服務的設定。

注意

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

規格需求

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