SERVICE_REQUIRED_PRIVILEGES_INFOW
構造体サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。
フィールド
| フィールド | 型 | サイズ | x64 | x86 | 説明 |
|---|---|---|---|---|---|
| pmszRequiredPrivileges | LPWSTR | 8/4 | +0 | +0 | 特権を指定するマルチ文字列です。指定できる値の一覧については、Privilege Constants を参照してください。 マルチ文字列とは、NULL で終わる文字列を連続して並べ、最後に空文字列 (\0) で終端したものです。例を次に示します: |
公式ドキュメント
サービスに必要な特権を表します。
解説(Remarks)
必要な特権の変更は、次にサービスが開始されるときに有効になります。SCM は、サービスの開始を試みる際に、指定された特権をそのサービスがサポートできるかどうかを判断します。
サービスを分析し、必要最小限の特権のセットを使用することをお勧めします。
必要な特権を設定しない場合、SCM はプロセストークンに既定で割り当てられているすべての特権を使用します。サービスに対して特権を指定した場合、SCM はプロセスの開始時に、必要でない特権をプロセストークンから削除します。複数のサービスが 1 つのプロセスを共有している場合、SCM はそのプロセス内のすべてのサービスが必要とする特権の和集合を計算します。
互換性のため、SeChangeNotifyPrivilege 特権は、プロセス内のどのサービスもその特権を要求していない場合でも、プロセストークンから削除されることはありません。したがって、サービスがこの特権を明示的に指定する必要はありません。
winsvc.h ヘッダーは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI 版または Unicode 版を自動的に選択するエイリアスとして SERVICE_REQUIRED_PRIVILEGES_INFO を定義しています。エンコーディング中立のエイリアスと、エンコーディング中立でないコードを混在させて使用すると、不一致が生じてコンパイルエラーや実行時エラーの原因となる場合があります。詳細については、Conventions for Function Prototypes を参照してください。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
各言語での定義
#include <windows.h>
// SERVICE_REQUIRED_PRIVILEGES_INFOW (x64 8 / x86 4 バイト)
typedef struct SERVICE_REQUIRED_PRIVILEGES_INFOW {
LPWSTR pmszRequiredPrivileges;
} SERVICE_REQUIRED_PRIVILEGES_INFOW;using System;
using System.Runtime.InteropServices;
[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct SERVICE_REQUIRED_PRIVILEGES_INFOW
{
public IntPtr pmszRequiredPrivileges;
}Imports System.Runtime.InteropServices
<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure SERVICE_REQUIRED_PRIVILEGES_INFOW
Public pmszRequiredPrivileges As IntPtr
End Structureimport ctypes
from ctypes import wintypes
class SERVICE_REQUIRED_PRIVILEGES_INFOW(ctypes.Structure):
_fields_ = [
("pmszRequiredPrivileges", ctypes.c_void_p),
]#[repr(C)]
pub struct SERVICE_REQUIRED_PRIVILEGES_INFOW {
pub pmszRequiredPrivileges: *mut core::ffi::c_void,
}import "golang.org/x/sys/windows"
type SERVICE_REQUIRED_PRIVILEGES_INFOW struct {
pmszRequiredPrivileges uintptr
}type
SERVICE_REQUIRED_PRIVILEGES_INFOW = record
pmszRequiredPrivileges: Pointer;
end;const SERVICE_REQUIRED_PRIVILEGES_INFOW = extern struct {
pmszRequiredPrivileges: ?*anyopaque,
};type
SERVICE_REQUIRED_PRIVILEGES_INFOW {.bycopy.} = object
pmszRequiredPrivileges: pointerstruct SERVICE_REQUIRED_PRIVILEGES_INFOW
{
void* pmszRequiredPrivileges;
}HSP用 定義
HSP3.7/3.8 は構造体機能が無いため4byte整数配列(dim)+peek/poke で操作(32/64bitでサイズ・位置が異なる場合はタブで分割)。IronHSP は NSTRUCT(#defstruct/stdim/->)で32/64bit共通。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; SERVICE_REQUIRED_PRIVILEGES_INFOW サイズ: 4 バイト(x86)
dim st, 1 ; 4byte整数×1(構造体サイズ 4 / 4 切り上げ)
; pmszRequiredPrivileges : LPWSTR (+0, 4byte) st.0 = 値 / 値 = st.0 (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; SERVICE_REQUIRED_PRIVILEGES_INFOW サイズ: 8 バイト(x64)
dim st, 2 ; 4byte整数×2(構造体サイズ 8 / 4 切り上げ)
; pmszRequiredPrivileges : LPWSTR (+0, 8byte) qpoke st,0,値 / qpeek(st,0) ※IronHSPのみ。3.7/3.8は lpoke st,0,下位 : lpoke st,4,上位
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global SERVICE_REQUIRED_PRIVILEGES_INFOW
#field intptr pmszRequiredPrivileges
#endstruct
stdim st, SERVICE_REQUIRED_PRIVILEGES_INFOW ; NSTRUCT 変数を確保