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

こちらもご覧ください

OpenService

GetServiceRegistryStateKey

SERVICE_SID_INFO