Win32 API 日本語リファレンス
ホームData.RightsManagement › DRMGetRightInfo

DRMGetRightInfo

関数
RMS権利の名前と有効期間を取得する。
DLLmsdrm.dll呼出規約winapi

シグネチャ

// msdrm.dll
#include <windows.h>

HRESULT DRMGetRightInfo(
    DWORD hRight,
    DWORD* puRightNameLength,
    LPWSTR wszRightName,   // optional
    SYSTEMTIME* pstFrom,
    SYSTEMTIME* pstUntil
);

パラメーター

名前方向
hRightDWORDin
puRightNameLengthDWORD*inout
wszRightNameLPWSTRoutoptional
pstFromSYSTEMTIME*inout
pstUntilSYSTEMTIME*inout

戻り値の型: HRESULT

各言語での呼び出し定義

// msdrm.dll
#include <windows.h>

HRESULT DRMGetRightInfo(
    DWORD hRight,
    DWORD* puRightNameLength,
    LPWSTR wszRightName,   // optional
    SYSTEMTIME* pstFrom,
    SYSTEMTIME* pstUntil
);
[DllImport("msdrm.dll", ExactSpelling = true)]
static extern int DRMGetRightInfo(
    uint hRight,   // DWORD
    ref uint puRightNameLength,   // DWORD* in/out
    [MarshalAs(UnmanagedType.LPWStr)] System.Text.StringBuilder wszRightName,   // LPWSTR optional, out
    IntPtr pstFrom,   // SYSTEMTIME* in/out
    IntPtr pstUntil   // SYSTEMTIME* in/out
);
<DllImport("msdrm.dll", ExactSpelling:=True)>
Public Shared Function DRMGetRightInfo(
    hRight As UInteger,   ' DWORD
    ByRef puRightNameLength As UInteger,   ' DWORD* in/out
    <MarshalAs(UnmanagedType.LPWStr)> wszRightName As System.Text.StringBuilder,   ' LPWSTR optional, out
    pstFrom As IntPtr,   ' SYSTEMTIME* in/out
    pstUntil As IntPtr   ' SYSTEMTIME* in/out
) As Integer
End Function
' hRight : DWORD
' puRightNameLength : DWORD* in/out
' wszRightName : LPWSTR optional, out
' pstFrom : SYSTEMTIME* in/out
' pstUntil : SYSTEMTIME* in/out
Declare PtrSafe Function DRMGetRightInfo Lib "msdrm" ( _
    ByVal hRight As Long, _
    ByRef puRightNameLength As Long, _
    ByVal wszRightName As LongPtr, _
    ByVal pstFrom As LongPtr, _
    ByVal pstUntil As LongPtr) As Long
' VBA7前提(PtrSafe)。32bit Office では LongPtr→Long。Integer=16bit / Long=32bit / LongLong=64bit。
import ctypes
from ctypes import wintypes

DRMGetRightInfo = ctypes.windll.msdrm.DRMGetRightInfo
DRMGetRightInfo.restype = ctypes.c_int
DRMGetRightInfo.argtypes = [
    wintypes.DWORD,  # hRight : DWORD
    ctypes.POINTER(wintypes.DWORD),  # puRightNameLength : DWORD* in/out
    wintypes.LPWSTR,  # wszRightName : LPWSTR optional, out
    ctypes.c_void_p,  # pstFrom : SYSTEMTIME* in/out
    ctypes.c_void_p,  # pstUntil : SYSTEMTIME* in/out
]
require 'fiddle'
require 'fiddle/import'

lib = Fiddle.dlopen('msdrm.dll')
DRMGetRightInfo = Fiddle::Function.new(
  lib['DRMGetRightInfo'],
  [
    -Fiddle::TYPE_INT,  # hRight : DWORD
    Fiddle::TYPE_VOIDP,  # puRightNameLength : DWORD* in/out
    Fiddle::TYPE_VOIDP,  # wszRightName : LPWSTR optional, out
    Fiddle::TYPE_VOIDP,  # pstFrom : SYSTEMTIME* in/out
    Fiddle::TYPE_VOIDP,  # pstUntil : SYSTEMTIME* in/out
  ],
  Fiddle::TYPE_INT)
#[link(name = "msdrm")]
extern "system" {
    fn DRMGetRightInfo(
        hRight: u32,  // DWORD
        puRightNameLength: *mut u32,  // DWORD* in/out
        wszRightName: *mut u16,  // LPWSTR optional, out
        pstFrom: *mut SYSTEMTIME,  // SYSTEMTIME* in/out
        pstUntil: *mut SYSTEMTIME  // SYSTEMTIME* in/out
    ) -> i32;
}
// crates: windows-sys provides ready-made bindings for this API.
$sig = @"
[DllImport("msdrm.dll")]
public static extern int DRMGetRightInfo(uint hRight, ref uint puRightNameLength, [MarshalAs(UnmanagedType.LPWStr)] System.Text.StringBuilder wszRightName, IntPtr pstFrom, IntPtr pstUntil);
"@
$api = Add-Type -MemberDefinition $sig -Name 'msdrm_DRMGetRightInfo' -Namespace Win32 -PassThru
# $api::DRMGetRightInfo(hRight, puRightNameLength, wszRightName, pstFrom, pstUntil)
#uselib "msdrm.dll"
#func global DRMGetRightInfo "DRMGetRightInfo" sptr, sptr, sptr, sptr, sptr
; DRMGetRightInfo hRight, varptr(puRightNameLength), varptr(wszRightName), varptr(pstFrom), varptr(pstUntil)   ; 戻り値は stat
; hRight : DWORD -> "sptr"
; puRightNameLength : DWORD* in/out -> "sptr"
; wszRightName : LPWSTR optional, out -> "sptr"
; pstFrom : SYSTEMTIME* in/out -> "sptr"
; pstUntil : SYSTEMTIME* in/out -> "sptr"
; ※HSP3.7は #func のため戻り値はシステム変数 stat に格納されます。
出力引数:
#uselib "msdrm.dll"
#cfunc global DRMGetRightInfo "DRMGetRightInfo" int, var, var, var, var
; res = DRMGetRightInfo(hRight, puRightNameLength, wszRightName, pstFrom, pstUntil)
; hRight : DWORD -> "int"
; puRightNameLength : DWORD* in/out -> "var"
; wszRightName : LPWSTR optional, out -> "var"
; pstFrom : SYSTEMTIME* in/out -> "var"
; pstUntil : SYSTEMTIME* in/out -> "var"
; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。
出力引数:
; HRESULT DRMGetRightInfo(DWORD hRight, DWORD* puRightNameLength, LPWSTR wszRightName, SYSTEMTIME* pstFrom, SYSTEMTIME* pstUntil)
#uselib "msdrm.dll"
#cfunc global DRMGetRightInfo "DRMGetRightInfo" int, var, var, var, var
; res = DRMGetRightInfo(hRight, puRightNameLength, wszRightName, pstFrom, pstUntil)
; hRight : DWORD -> "int"
; puRightNameLength : DWORD* in/out -> "var"
; wszRightName : LPWSTR optional, out -> "var"
; pstFrom : SYSTEMTIME* in/out -> "var"
; pstUntil : SYSTEMTIME* in/out -> "var"
; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。
import (
	"golang.org/x/sys/windows"
	"unsafe"
)

var (
	msdrm = windows.NewLazySystemDLL("msdrm.dll")
	procDRMGetRightInfo = msdrm.NewProc("DRMGetRightInfo")
)

// hRight (DWORD), puRightNameLength (DWORD* in/out), wszRightName (LPWSTR optional, out), pstFrom (SYSTEMTIME* in/out), pstUntil (SYSTEMTIME* in/out)
r1, _, err := procDRMGetRightInfo.Call(
	uintptr(hRight),
	uintptr(puRightNameLength),
	uintptr(wszRightName),
	uintptr(pstFrom),
	uintptr(pstUntil),
)
_ = err  // syscall.Errno (valid when the call sets last-error)
_ = r1   // HRESULT
function DRMGetRightInfo(
  hRight: DWORD;   // DWORD
  puRightNameLength: Pointer;   // DWORD* in/out
  wszRightName: PWideChar;   // LPWSTR optional, out
  pstFrom: Pointer;   // SYSTEMTIME* in/out
  pstUntil: Pointer   // SYSTEMTIME* in/out
): Integer; stdcall;
  external 'msdrm.dll' name 'DRMGetRightInfo';
result := DllCall("msdrm\DRMGetRightInfo"
    , "UInt", hRight   ; DWORD
    , "Ptr", puRightNameLength   ; DWORD* in/out
    , "Ptr", wszRightName   ; LPWSTR optional, out
    , "Ptr", pstFrom   ; SYSTEMTIME* in/out
    , "Ptr", pstUntil   ; SYSTEMTIME* in/out
    , "Int")   ; return: HRESULT
●DRMGetRightInfo(hRight, puRightNameLength, wszRightName, pstFrom, pstUntil) = DLL("msdrm.dll", "int DRMGetRightInfo(dword, void*, char*, void*, void*)")
# 呼び出し: DRMGetRightInfo(hRight, puRightNameLength, wszRightName, pstFrom, pstUntil)
# hRight : DWORD -> "dword"
# puRightNameLength : DWORD* in/out -> "void*"
# wszRightName : LPWSTR optional, out -> "char*"
# pstFrom : SYSTEMTIME* in/out -> "void*"
# pstUntil : SYSTEMTIME* in/out -> "void*"
# なでしこ1は32bit・ANSI(Shift_JIS)。文字列=char*(ANSI)、ポインタ/ハンドル=void*(4byte)。