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

こちらもご覧ください

RegisterServiceCtrlHandler

GetSharedServiceRegistryStateKey

SERVICE_SID_INFO