ホーム › Data.RightsManagement › DRMCreateRight

DRMCreateRight

関数

RMSの権利オブジェクトを作成する。

DLLmsdrm.dll呼出規約winapi

シグネチャ

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

HRESULT DRMCreateRight(
    LPWSTR wszRightName,
    SYSTEMTIME* pstFrom,
    SYSTEMTIME* pstUntil,
    DWORD cExtendedInfo,
    LPWSTR* pwszExtendedInfoName,   // optional
    LPWSTR* pwszExtendedInfoValue,   // optional
    DWORD* phRight
);

パラメーター

名前	型	方向
wszRightName	LPWSTR	in
pstFrom	SYSTEMTIME*	inout
pstUntil	SYSTEMTIME*	inout
cExtendedInfo	DWORD	in
pwszExtendedInfoName	LPWSTR*	inoptional
pwszExtendedInfoValue	LPWSTR*	inoptional
phRight	DWORD*	inout

戻り値の型: HRESULT

各言語での呼び出し定義

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

HRESULT DRMCreateRight(
    LPWSTR wszRightName,
    SYSTEMTIME* pstFrom,
    SYSTEMTIME* pstUntil,
    DWORD cExtendedInfo,
    LPWSTR* pwszExtendedInfoName,   // optional
    LPWSTR* pwszExtendedInfoValue,   // optional
    DWORD* phRight
);

[DllImport("msdrm.dll", ExactSpelling = true)]
static extern int DRMCreateRight(
    [MarshalAs(UnmanagedType.LPWStr)] string wszRightName,   // LPWSTR
    IntPtr pstFrom,   // SYSTEMTIME* in/out
    IntPtr pstUntil,   // SYSTEMTIME* in/out
    uint cExtendedInfo,   // DWORD
    IntPtr pwszExtendedInfoName,   // LPWSTR* optional
    IntPtr pwszExtendedInfoValue,   // LPWSTR* optional
    ref uint phRight   // DWORD* in/out
);

<DllImport("msdrm.dll", ExactSpelling:=True)>
Public Shared Function DRMCreateRight(
    <MarshalAs(UnmanagedType.LPWStr)> wszRightName As String,   ' LPWSTR
    pstFrom As IntPtr,   ' SYSTEMTIME* in/out
    pstUntil As IntPtr,   ' SYSTEMTIME* in/out
    cExtendedInfo As UInteger,   ' DWORD
    pwszExtendedInfoName As IntPtr,   ' LPWSTR* optional
    pwszExtendedInfoValue As IntPtr,   ' LPWSTR* optional
    ByRef phRight As UInteger   ' DWORD* in/out
) As Integer
End Function

' wszRightName : LPWSTR
' pstFrom : SYSTEMTIME* in/out
' pstUntil : SYSTEMTIME* in/out
' cExtendedInfo : DWORD
' pwszExtendedInfoName : LPWSTR* optional
' pwszExtendedInfoValue : LPWSTR* optional
' phRight : DWORD* in/out
Declare PtrSafe Function DRMCreateRight Lib "msdrm" ( _
    ByVal wszRightName As LongPtr, _
    ByVal pstFrom As LongPtr, _
    ByVal pstUntil As LongPtr, _
    ByVal cExtendedInfo As Long, _
    ByVal pwszExtendedInfoName As LongPtr, _
    ByVal pwszExtendedInfoValue As LongPtr, _
    ByRef phRight As Long) As Long
' VBA7前提(PtrSafe)。32bit Office では LongPtr→Long。Integer=16bit / Long=32bit / LongLong=64bit。

import ctypes
from ctypes import wintypes

DRMCreateRight = ctypes.windll.msdrm.DRMCreateRight
DRMCreateRight.restype = ctypes.c_int
DRMCreateRight.argtypes = [
    wintypes.LPCWSTR,  # wszRightName : LPWSTR
    ctypes.c_void_p,  # pstFrom : SYSTEMTIME* in/out
    ctypes.c_void_p,  # pstUntil : SYSTEMTIME* in/out
    wintypes.DWORD,  # cExtendedInfo : DWORD
    ctypes.c_void_p,  # pwszExtendedInfoName : LPWSTR* optional
    ctypes.c_void_p,  # pwszExtendedInfoValue : LPWSTR* optional
    ctypes.POINTER(wintypes.DWORD),  # phRight : DWORD* in/out
]

require 'fiddle'
require 'fiddle/import'

lib = Fiddle.dlopen('msdrm.dll')
DRMCreateRight = Fiddle::Function.new(
  lib['DRMCreateRight'],
  [
    Fiddle::TYPE_VOIDP,  # wszRightName : LPWSTR
    Fiddle::TYPE_VOIDP,  # pstFrom : SYSTEMTIME* in/out
    Fiddle::TYPE_VOIDP,  # pstUntil : SYSTEMTIME* in/out
    -Fiddle::TYPE_INT,  # cExtendedInfo : DWORD
    Fiddle::TYPE_VOIDP,  # pwszExtendedInfoName : LPWSTR* optional
    Fiddle::TYPE_VOIDP,  # pwszExtendedInfoValue : LPWSTR* optional
    Fiddle::TYPE_VOIDP,  # phRight : DWORD* in/out
  ],
  Fiddle::TYPE_INT)

#[link(name = "msdrm")]
extern "system" {
    fn DRMCreateRight(
        wszRightName: *mut u16,  // LPWSTR
        pstFrom: *mut SYSTEMTIME,  // SYSTEMTIME* in/out
        pstUntil: *mut SYSTEMTIME,  // SYSTEMTIME* in/out
        cExtendedInfo: u32,  // DWORD
        pwszExtendedInfoName: *mut *mut u16,  // LPWSTR* optional
        pwszExtendedInfoValue: *mut *mut u16,  // LPWSTR* optional
        phRight: *mut u32  // DWORD* in/out
    ) -> i32;
}
// crates: windows-sys provides ready-made bindings for this API.

$sig = @"
[DllImport("msdrm.dll")]
public static extern int DRMCreateRight([MarshalAs(UnmanagedType.LPWStr)] string wszRightName, IntPtr pstFrom, IntPtr pstUntil, uint cExtendedInfo, IntPtr pwszExtendedInfoName, IntPtr pwszExtendedInfoValue, ref uint phRight);
"@
$api = Add-Type -MemberDefinition $sig -Name 'msdrm_DRMCreateRight' -Namespace Win32 -PassThru
# $api::DRMCreateRight(wszRightName, pstFrom, pstUntil, cExtendedInfo, pwszExtendedInfoName, pwszExtendedInfoValue, phRight)

#uselib "msdrm.dll"
#func global DRMCreateRight "DRMCreateRight" sptr, sptr, sptr, sptr, sptr, sptr, sptr
; DRMCreateRight wszRightName, varptr(pstFrom), varptr(pstUntil), cExtendedInfo, varptr(pwszExtendedInfoName), varptr(pwszExtendedInfoValue), varptr(phRight)   ; 戻り値は stat
; wszRightName : LPWSTR -> "sptr"
; pstFrom : SYSTEMTIME* in/out -> "sptr"
; pstUntil : SYSTEMTIME* in/out -> "sptr"
; cExtendedInfo : DWORD -> "sptr"
; pwszExtendedInfoName : LPWSTR* optional -> "sptr"
; pwszExtendedInfoValue : LPWSTR* optional -> "sptr"
; phRight : DWORD* in/out -> "sptr"
; ※HSP3.7は #func のため戻り値はシステム変数 stat に格納されます。

出力引数:

#uselib "msdrm.dll"
#cfunc global DRMCreateRight "DRMCreateRight" wstr, var, var, int, var, var, var
; res = DRMCreateRight(wszRightName, pstFrom, pstUntil, cExtendedInfo, pwszExtendedInfoName, pwszExtendedInfoValue, phRight)
; wszRightName : LPWSTR -> "wstr"
; pstFrom : SYSTEMTIME* in/out -> "var"
; pstUntil : SYSTEMTIME* in/out -> "var"
; cExtendedInfo : DWORD -> "int"
; pwszExtendedInfoName : LPWSTR* optional -> "var"
; pwszExtendedInfoValue : LPWSTR* optional -> "var"
; phRight : DWORD* in/out -> "var"
; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。#uselib "msdrm.dll"
#cfunc global DRMCreateRight "DRMCreateRight" wstr, sptr, sptr, int, sptr, sptr, sptr
; res = DRMCreateRight(wszRightName, varptr(pstFrom), varptr(pstUntil), cExtendedInfo, varptr(pwszExtendedInfoName), varptr(pwszExtendedInfoValue), varptr(phRight))
; wszRightName : LPWSTR -> "wstr"
; pstFrom : SYSTEMTIME* in/out -> "sptr"
; pstUntil : SYSTEMTIME* in/out -> "sptr"
; cExtendedInfo : DWORD -> "int"
; pwszExtendedInfoName : LPWSTR* optional -> "sptr"
; pwszExtendedInfoValue : LPWSTR* optional -> "sptr"
; phRight : DWORD* in/out -> "sptr"
; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。

出力引数:

; HRESULT DRMCreateRight(LPWSTR wszRightName, SYSTEMTIME* pstFrom, SYSTEMTIME* pstUntil, DWORD cExtendedInfo, LPWSTR* pwszExtendedInfoName, LPWSTR* pwszExtendedInfoValue, DWORD* phRight)
#uselib "msdrm.dll"
#cfunc global DRMCreateRight "DRMCreateRight" wstr, var, var, int, var, var, var
; res = DRMCreateRight(wszRightName, pstFrom, pstUntil, cExtendedInfo, pwszExtendedInfoName, pwszExtendedInfoValue, phRight)
; wszRightName : LPWSTR -> "wstr"
; pstFrom : SYSTEMTIME* in/out -> "var"
; pstUntil : SYSTEMTIME* in/out -> "var"
; cExtendedInfo : DWORD -> "int"
; pwszExtendedInfoName : LPWSTR* optional -> "var"
; pwszExtendedInfoValue : LPWSTR* optional -> "var"
; phRight : DWORD* in/out -> "var"
; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。; HRESULT DRMCreateRight(LPWSTR wszRightName, SYSTEMTIME* pstFrom, SYSTEMTIME* pstUntil, DWORD cExtendedInfo, LPWSTR* pwszExtendedInfoName, LPWSTR* pwszExtendedInfoValue, DWORD* phRight)
#uselib "msdrm.dll"
#cfunc global DRMCreateRight "DRMCreateRight" wstr, intptr, intptr, int, intptr, intptr, intptr
; res = DRMCreateRight(wszRightName, varptr(pstFrom), varptr(pstUntil), cExtendedInfo, varptr(pwszExtendedInfoName), varptr(pwszExtendedInfoValue), varptr(phRight))
; wszRightName : LPWSTR -> "wstr"
; pstFrom : SYSTEMTIME* in/out -> "intptr"
; pstUntil : SYSTEMTIME* in/out -> "intptr"
; cExtendedInfo : DWORD -> "int"
; pwszExtendedInfoName : LPWSTR* optional -> "intptr"
; pwszExtendedInfoValue : LPWSTR* optional -> "intptr"
; phRight : DWORD* in/out -> "intptr"
; ※出力/バッファ引数はポインタ方式(token=intptr / 呼び出しは varptr(変数))。

import (
	"golang.org/x/sys/windows"
	"unsafe"
)

var (
	msdrm = windows.NewLazySystemDLL("msdrm.dll")
	procDRMCreateRight = msdrm.NewProc("DRMCreateRight")
)

// wszRightName (LPWSTR), pstFrom (SYSTEMTIME* in/out), pstUntil (SYSTEMTIME* in/out), cExtendedInfo (DWORD), pwszExtendedInfoName (LPWSTR* optional), pwszExtendedInfoValue (LPWSTR* optional), phRight (DWORD* in/out)
r1, _, err := procDRMCreateRight.Call(
	uintptr(unsafe.Pointer(windows.StringToUTF16Ptr(wszRightName))),
	uintptr(pstFrom),
	uintptr(pstUntil),
	uintptr(cExtendedInfo),
	uintptr(pwszExtendedInfoName),
	uintptr(pwszExtendedInfoValue),
	uintptr(phRight),
)
_ = err  // syscall.Errno (valid when the call sets last-error)
_ = r1   // HRESULT

function DRMCreateRight(
  wszRightName: PWideChar;   // LPWSTR
  pstFrom: Pointer;   // SYSTEMTIME* in/out
  pstUntil: Pointer;   // SYSTEMTIME* in/out
  cExtendedInfo: DWORD;   // DWORD
  pwszExtendedInfoName: PPWideChar;   // LPWSTR* optional
  pwszExtendedInfoValue: PPWideChar;   // LPWSTR* optional
  phRight: Pointer   // DWORD* in/out
): Integer; stdcall;
  external 'msdrm.dll' name 'DRMCreateRight';

result := DllCall("msdrm\DRMCreateRight"
    , "WStr", wszRightName   ; LPWSTR
    , "Ptr", pstFrom   ; SYSTEMTIME* in/out
    , "Ptr", pstUntil   ; SYSTEMTIME* in/out
    , "UInt", cExtendedInfo   ; DWORD
    , "Ptr", pwszExtendedInfoName   ; LPWSTR* optional
    , "Ptr", pwszExtendedInfoValue   ; LPWSTR* optional
    , "Ptr", phRight   ; DWORD* in/out
    , "Int")   ; return: HRESULT

●DRMCreateRight(wszRightName, pstFrom, pstUntil, cExtendedInfo, pwszExtendedInfoName, pwszExtendedInfoValue, phRight) = DLL("msdrm.dll", "int DRMCreateRight(char*, void*, void*, dword, void*, void*, void*)")
# 呼び出し: DRMCreateRight(wszRightName, pstFrom, pstUntil, cExtendedInfo, pwszExtendedInfoName, pwszExtendedInfoValue, phRight)
# wszRightName : LPWSTR -> "char*"
# pstFrom : SYSTEMTIME* in/out -> "void*"
# pstUntil : SYSTEMTIME* in/out -> "void*"
# cExtendedInfo : DWORD -> "dword"
# pwszExtendedInfoName : LPWSTR* optional -> "void*"
# pwszExtendedInfoValue : LPWSTR* optional -> "void*"
# phRight : DWORD* in/out -> "void*"
# なでしこ1は32bit・ANSI(Shift_JIS)。文字列=char*(ANSI)、ポインタ/ハンドル=void*(4byte)。