ホーム › System.GroupPolicy › RsopFileAccessCheck
RsopFileAccessCheck
関数RSOPトークンでファイルへのアクセス許可を判定する。
シグネチャ
// USERENV.dll
#include <windows.h>
HRESULT RsopFileAccessCheck(
LPWSTR pszFileName,
void* pRsopToken,
DWORD dwDesiredAccessMask,
DWORD* pdwGrantedAccessMask,
BOOL* pbAccessStatus
);パラメーター
| 名前 | 型 | 方向 |
|---|---|---|
| pszFileName | LPWSTR | in |
| pRsopToken | void* | in |
| dwDesiredAccessMask | DWORD | in |
| pdwGrantedAccessMask | DWORD* | out |
| pbAccessStatus | BOOL* | out |
戻り値の型: HRESULT
各言語での呼び出し定義
// USERENV.dll
#include <windows.h>
HRESULT RsopFileAccessCheck(
LPWSTR pszFileName,
void* pRsopToken,
DWORD dwDesiredAccessMask,
DWORD* pdwGrantedAccessMask,
BOOL* pbAccessStatus
);[DllImport("USERENV.dll", ExactSpelling = true)]
static extern int RsopFileAccessCheck(
[MarshalAs(UnmanagedType.LPWStr)] string pszFileName, // LPWSTR
IntPtr pRsopToken, // void*
uint dwDesiredAccessMask, // DWORD
out uint pdwGrantedAccessMask, // DWORD* out
out int pbAccessStatus // BOOL* out
);<DllImport("USERENV.dll", ExactSpelling:=True)>
Public Shared Function RsopFileAccessCheck(
<MarshalAs(UnmanagedType.LPWStr)> pszFileName As String, ' LPWSTR
pRsopToken As IntPtr, ' void*
dwDesiredAccessMask As UInteger, ' DWORD
<Out> ByRef pdwGrantedAccessMask As UInteger, ' DWORD* out
<Out> ByRef pbAccessStatus As Integer ' BOOL* out
) As Integer
End Function' pszFileName : LPWSTR
' pRsopToken : void*
' dwDesiredAccessMask : DWORD
' pdwGrantedAccessMask : DWORD* out
' pbAccessStatus : BOOL* out
Declare PtrSafe Function RsopFileAccessCheck Lib "userenv" ( _
ByVal pszFileName As LongPtr, _
ByVal pRsopToken As LongPtr, _
ByVal dwDesiredAccessMask As Long, _
ByRef pdwGrantedAccessMask As Long, _
ByRef pbAccessStatus As Long) As Long
' VBA7前提(PtrSafe)。32bit Office では LongPtr→Long。Integer=16bit / Long=32bit / LongLong=64bit。import ctypes
from ctypes import wintypes
RsopFileAccessCheck = ctypes.windll.userenv.RsopFileAccessCheck
RsopFileAccessCheck.restype = ctypes.c_int
RsopFileAccessCheck.argtypes = [
wintypes.LPCWSTR, # pszFileName : LPWSTR
ctypes.POINTER(None), # pRsopToken : void*
wintypes.DWORD, # dwDesiredAccessMask : DWORD
ctypes.POINTER(wintypes.DWORD), # pdwGrantedAccessMask : DWORD* out
ctypes.c_void_p, # pbAccessStatus : BOOL* out
]require 'fiddle'
require 'fiddle/import'
lib = Fiddle.dlopen('USERENV.dll')
RsopFileAccessCheck = Fiddle::Function.new(
lib['RsopFileAccessCheck'],
[
Fiddle::TYPE_VOIDP, # pszFileName : LPWSTR
Fiddle::TYPE_VOIDP, # pRsopToken : void*
-Fiddle::TYPE_INT, # dwDesiredAccessMask : DWORD
Fiddle::TYPE_VOIDP, # pdwGrantedAccessMask : DWORD* out
Fiddle::TYPE_VOIDP, # pbAccessStatus : BOOL* out
],
Fiddle::TYPE_INT)#[link(name = "userenv")]
extern "system" {
fn RsopFileAccessCheck(
pszFileName: *mut u16, // LPWSTR
pRsopToken: *mut (), // void*
dwDesiredAccessMask: u32, // DWORD
pdwGrantedAccessMask: *mut u32, // DWORD* out
pbAccessStatus: *mut i32 // BOOL* out
) -> i32;
}
// crates: windows-sys provides ready-made bindings for this API.$sig = @"
[DllImport("USERENV.dll")]
public static extern int RsopFileAccessCheck([MarshalAs(UnmanagedType.LPWStr)] string pszFileName, IntPtr pRsopToken, uint dwDesiredAccessMask, out uint pdwGrantedAccessMask, out int pbAccessStatus);
"@
$api = Add-Type -MemberDefinition $sig -Name 'USERENV_RsopFileAccessCheck' -Namespace Win32 -PassThru
# $api::RsopFileAccessCheck(pszFileName, pRsopToken, dwDesiredAccessMask, pdwGrantedAccessMask, pbAccessStatus)#uselib "USERENV.dll"
#func global RsopFileAccessCheck "RsopFileAccessCheck" sptr, sptr, sptr, sptr, sptr
; RsopFileAccessCheck pszFileName, pRsopToken, dwDesiredAccessMask, varptr(pdwGrantedAccessMask), pbAccessStatus ; 戻り値は stat
; pszFileName : LPWSTR -> "sptr"
; pRsopToken : void* -> "sptr"
; dwDesiredAccessMask : DWORD -> "sptr"
; pdwGrantedAccessMask : DWORD* out -> "sptr"
; pbAccessStatus : BOOL* out -> "sptr"
; ※HSP3.7は #func のため戻り値はシステム変数 stat に格納されます。出力引数:
#uselib "USERENV.dll" #cfunc global RsopFileAccessCheck "RsopFileAccessCheck" wstr, sptr, int, var, int ; res = RsopFileAccessCheck(pszFileName, pRsopToken, dwDesiredAccessMask, pdwGrantedAccessMask, pbAccessStatus) ; pszFileName : LPWSTR -> "wstr" ; pRsopToken : void* -> "sptr" ; dwDesiredAccessMask : DWORD -> "int" ; pdwGrantedAccessMask : DWORD* out -> "var" ; pbAccessStatus : BOOL* out -> "int" ; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。#uselib "USERENV.dll" #cfunc global RsopFileAccessCheck "RsopFileAccessCheck" wstr, sptr, int, sptr, int ; res = RsopFileAccessCheck(pszFileName, pRsopToken, dwDesiredAccessMask, varptr(pdwGrantedAccessMask), pbAccessStatus) ; pszFileName : LPWSTR -> "wstr" ; pRsopToken : void* -> "sptr" ; dwDesiredAccessMask : DWORD -> "int" ; pdwGrantedAccessMask : DWORD* out -> "sptr" ; pbAccessStatus : BOOL* out -> "int" ; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。
出力引数:
; HRESULT RsopFileAccessCheck(LPWSTR pszFileName, void* pRsopToken, DWORD dwDesiredAccessMask, DWORD* pdwGrantedAccessMask, BOOL* pbAccessStatus) #uselib "USERENV.dll" #cfunc global RsopFileAccessCheck "RsopFileAccessCheck" wstr, intptr, int, var, int ; res = RsopFileAccessCheck(pszFileName, pRsopToken, dwDesiredAccessMask, pdwGrantedAccessMask, pbAccessStatus) ; pszFileName : LPWSTR -> "wstr" ; pRsopToken : void* -> "intptr" ; dwDesiredAccessMask : DWORD -> "int" ; pdwGrantedAccessMask : DWORD* out -> "var" ; pbAccessStatus : BOOL* out -> "int" ; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。; HRESULT RsopFileAccessCheck(LPWSTR pszFileName, void* pRsopToken, DWORD dwDesiredAccessMask, DWORD* pdwGrantedAccessMask, BOOL* pbAccessStatus) #uselib "USERENV.dll" #cfunc global RsopFileAccessCheck "RsopFileAccessCheck" wstr, intptr, int, intptr, int ; res = RsopFileAccessCheck(pszFileName, pRsopToken, dwDesiredAccessMask, varptr(pdwGrantedAccessMask), pbAccessStatus) ; pszFileName : LPWSTR -> "wstr" ; pRsopToken : void* -> "intptr" ; dwDesiredAccessMask : DWORD -> "int" ; pdwGrantedAccessMask : DWORD* out -> "intptr" ; pbAccessStatus : BOOL* out -> "int" ; ※出力/バッファ引数はポインタ方式(token=intptr / 呼び出しは varptr(変数))。
import (
"golang.org/x/sys/windows"
"unsafe"
)
var (
userenv = windows.NewLazySystemDLL("USERENV.dll")
procRsopFileAccessCheck = userenv.NewProc("RsopFileAccessCheck")
)
// pszFileName (LPWSTR), pRsopToken (void*), dwDesiredAccessMask (DWORD), pdwGrantedAccessMask (DWORD* out), pbAccessStatus (BOOL* out)
r1, _, err := procRsopFileAccessCheck.Call(
uintptr(unsafe.Pointer(windows.StringToUTF16Ptr(pszFileName))),
uintptr(pRsopToken),
uintptr(dwDesiredAccessMask),
uintptr(pdwGrantedAccessMask),
uintptr(pbAccessStatus),
)
_ = err // syscall.Errno (valid when the call sets last-error)
_ = r1 // HRESULTfunction RsopFileAccessCheck(
pszFileName: PWideChar; // LPWSTR
pRsopToken: Pointer; // void*
dwDesiredAccessMask: DWORD; // DWORD
pdwGrantedAccessMask: Pointer; // DWORD* out
pbAccessStatus: Pointer // BOOL* out
): Integer; stdcall;
external 'USERENV.dll' name 'RsopFileAccessCheck';result := DllCall("USERENV\RsopFileAccessCheck"
, "WStr", pszFileName ; LPWSTR
, "Ptr", pRsopToken ; void*
, "UInt", dwDesiredAccessMask ; DWORD
, "Ptr", pdwGrantedAccessMask ; DWORD* out
, "Ptr", pbAccessStatus ; BOOL* out
, "Int") ; return: HRESULT●RsopFileAccessCheck(pszFileName, pRsopToken, dwDesiredAccessMask, pdwGrantedAccessMask, pbAccessStatus) = DLL("USERENV.dll", "int RsopFileAccessCheck(char*, void*, dword, void*, void*)")
# 呼び出し: RsopFileAccessCheck(pszFileName, pRsopToken, dwDesiredAccessMask, pdwGrantedAccessMask, pbAccessStatus)
# pszFileName : LPWSTR -> "char*"
# pRsopToken : void* -> "void*"
# dwDesiredAccessMask : DWORD -> "dword"
# pdwGrantedAccessMask : DWORD* out -> "void*"
# pbAccessStatus : BOOL* out -> "void*"
# なでしこ1は32bit・ANSI(Shift_JIS)。文字列=char*(ANSI)、ポインタ/ハンドル=void*(4byte)。