SetNamedSecurityInfoW

指定したオブジェクトのセキュリティ記述子に、指定したセキュリティ情報を設定する。(Unicode)

SetNamedSecurityInfoW pObjectName, ObjectType, SecurityInfo, psidOwner, psidGroup, pDacl, pSacl

pObjectName : [wstr] セキュリティ情報を設定する対象のオブジェクトの名前を指定する null 終端文字列へのポインタ。これは NTFS ファイルシステム上のローカルまたはリモートファイル/ディレクトリ、ネットワーク共有、レジストリキー、セマフォ、イベント、ミューテックス、ファイルマッピング、または待機可能タイマの名前にできる。
ObjectType : [int] pObjectName パラメータで指定されるオブジェクトの種類を示す SE_OBJECT_TYPE 列挙の値。
SecurityInfo : [int] 設定するセキュリティ情報の種類を示すビットフラグの集合。このパラメータには SECURITY_INFORMATION ビットフラグの組み合わせを指定できる。
psidOwner : [int] オブジェクトの所有者を識別する SID 構造体へのポインタ。呼び出し側が SeRestorePrivilege 定数（特権定数を参照のこと）を持たない場合、この SID は呼び出し側のトークンに含まれている必要があり、SE_GROUP_OWNER パーミッションが有効になっている必要がある。SecurityInfo パラメータには OWNER_SECURITY_INFORMATION フラグが含まれている必要がある。所有者を設定するには、呼び出し側はオブジェクトに対する WRITE_OWNER アクセス権を持つか、SE_TAKE_OWNERSHIP_NAME 特権を有効にしている必要がある。所有者 SID を設定しない場合、このパラメータは NULL にできる。
psidGroup : [int] オブジェクトのプライマリグループを識別する SID へのポインタ。SecurityInfo パラメータには GROUP_SECURITY_INFORMATION フラグが含まれている必要がある。プライマリグループ SID を設定しない場合、このパラメータは NULL にできる。
pDacl : [var] オブジェクトの新しい DACL へのポインタ。SecurityInfo パラメータには DACL_SECURITY_INFORMATION フラグが含まれている必要がある。呼び出し側はオブジェクトに対する WRITE_DAC アクセス権を持っているか、オブジェクトの所有者でなければならない。DACL を設定しない場合、このパラメータは NULL にできる。
pSacl : [var] オブジェクトの新しい SACL へのポインタ。SecurityInfo パラメータは、SACL_SECURITY_INFORMATION、LABEL_SECURITY_INFORMATION、ATTRIBUTE_SECURITY_INFORMATION、SCOPE_SECURITY_INFORMATION、または BACKUP_SECURITY_INFORMATION のいずれかのフラグを含んでいる必要がある。

(プラグイン / モジュール : advapi32.dll)

解説

指定したオブジェクトのセキュリティ記述子に、指定したセキュリティ情報を設定する。(Unicode)

[戻り値]
関数が成功した場合、関数は ERROR_SUCCESS を返す。関数が失敗した場合、WinError.h で定義された 0
以外のエラーコードを返す。

[備考]
オブジェクトの任意アクセス制御リスト (DACL) またはシステムアクセス制御リスト (SACL)
の要素を設定する場合、システムは継承規則に従って、継承可能なアクセス制御エントリ (ACE)
を既存の子オブジェクトに自動的に伝播する。SetNamedSecurityInfo 関数は以下の種類のオブジェクトに使用できる:
（以下省略）

情報