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