win32_add_right_access_service

(PECL win32service >=1.1.0)

win32_add_right_access_service — ユーザー名に対する、サービスへのアクセス権を追加する

説明

function win32_add_right_access_service(
    string $servicename,
    string $username,
    int $right,
    string $machine = null
): void

servicename 上の username に、アクセス権を追加します。これが成功するには、管理者権限が必要です。

パラメータ

servicename: アクセス権を追加するサービス名
username: username のためのアクセス権を読み取ります
right: username に許可するアクセス権。この値を定義するために定数の値が使えます。
machine: サービスを作成したいオプションのマシン名。省略すると、ローカルマシン名を使います。

戻り値

Win32Service\RightInfo オブジェクトを返します。

エラー / 例外

service パラメータが空の場合は、 ValueError がスローされます。

username パラメータが空の場合は、 ValueError がスローされます。

エラー時には Win32ServiceException がスローされます。

参考

win32_read_all_rights_access_service() - サービスへのアクセス権をすべて読み取る
win32_read_rights_access_service()
win32_remove_right_access_service() - ユーザー名に対する、サービスへのアクセス権を削除する
Win32 Rights constants

関連キーワード:

service アクセス権サービス right access username ユーザー名 servicename machine マシン ValueError read 成功管理者権限許可定数省略ローカル Service RightInfo ServiceException 参考 remove constants