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) |
| Header | winsvc.h |
| Library | Onecore.lib |