getSharedServiceRegistryStateKey 函式 (winsvc.h)
傳回服務登錄機碼的句柄，以及要讀取和/或寫入狀態的相關程式。
語法
DWORD GetSharedServiceRegistryStateKey(
SC_HANDLE ServiceHandle,
SERVICE_SHARED_REGISTRY_STATE_TYPE StateType,
DWORD AccessMask,
HKEY *ServiceStateKey
);
參數
ServiceHandle
StateType
SERVICE_SHARED_REGISTRY_STATE_TYPE的成員，指定擷取服務登錄機碼的共享狀態類型。
AccessMask
要嘗試開啟狀態金鑰的存取掩碼。 如需詳細資訊，請參閱 登錄機碼安全性和訪問許可權。
ServiceStateKey
接收輸出登錄機碼句柄。
傳回值
當所有作業都順利完成時ERROR_SUCCESS;否則為 Win32 錯誤碼。
備註
針對 ServiceSharedRegistryStatePersistent，目錄的安全性會設定為只提供本機系統帳戶、服務 SID 和本機系統管理員的寫入許可權。 請確定呼叫此 API 的任何服務都已啟用服務 SID。 如需詳細資訊，請參閱 SERVICE_SID_INFO。
如需專門提供服務狀態以供服務本身使用的類似 API，請參閱 GetServiceRegistryStateKey。
卸載服務之後，服務控制管理員會刪除所有服務狀態登錄機碼。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows 11 (組建 22000) |
| 最低支援的伺服器 | Windows Server 2022 (組建 20348) |
| 標頭 | winsvc.h |
| 程式庫 | Onecore.lib |