ホーム › Data.RightsManagement › DRMGetRightExtendedInfo

DRMGetRightExtendedInfo

関数

RMS権利の拡張情報を取得する。

DLLmsdrm.dll呼出規約winapi

シグネチャ

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

HRESULT DRMGetRightExtendedInfo(
    DWORD hRight,
    DWORD uIndex,
    DWORD* puExtendedInfoNameLength,
    LPWSTR wszExtendedInfoName,   // optional
    DWORD* puExtendedInfoValueLength,
    LPWSTR wszExtendedInfoValue   // optional
);

パラメーター

名前	型	方向
hRight	DWORD	in
uIndex	DWORD	in
puExtendedInfoNameLength	DWORD*	inout
wszExtendedInfoName	LPWSTR	outoptional
puExtendedInfoValueLength	DWORD*	inout
wszExtendedInfoValue	LPWSTR	outoptional

戻り値の型: HRESULT

各言語での呼び出し定義

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

HRESULT DRMGetRightExtendedInfo(
    DWORD hRight,
    DWORD uIndex,
    DWORD* puExtendedInfoNameLength,
    LPWSTR wszExtendedInfoName,   // optional
    DWORD* puExtendedInfoValueLength,
    LPWSTR wszExtendedInfoValue   // optional
);

[DllImport("msdrm.dll", ExactSpelling = true)]
static extern int DRMGetRightExtendedInfo(
    uint hRight,   // DWORD
    uint uIndex,   // DWORD
    ref uint puExtendedInfoNameLength,   // DWORD* in/out
    [MarshalAs(UnmanagedType.LPWStr)] System.Text.StringBuilder wszExtendedInfoName,   // LPWSTR optional, out
    ref uint puExtendedInfoValueLength,   // DWORD* in/out
    [MarshalAs(UnmanagedType.LPWStr)] System.Text.StringBuilder wszExtendedInfoValue   // LPWSTR optional, out
);

<DllImport("msdrm.dll", ExactSpelling:=True)>
Public Shared Function DRMGetRightExtendedInfo(
    hRight As UInteger,   ' DWORD
    uIndex As UInteger,   ' DWORD
    ByRef puExtendedInfoNameLength As UInteger,   ' DWORD* in/out
    <MarshalAs(UnmanagedType.LPWStr)> wszExtendedInfoName As System.Text.StringBuilder,   ' LPWSTR optional, out
    ByRef puExtendedInfoValueLength As UInteger,   ' DWORD* in/out
    <MarshalAs(UnmanagedType.LPWStr)> wszExtendedInfoValue As System.Text.StringBuilder   ' LPWSTR optional, out
) As Integer
End Function

' hRight : DWORD
' uIndex : DWORD
' puExtendedInfoNameLength : DWORD* in/out
' wszExtendedInfoName : LPWSTR optional, out
' puExtendedInfoValueLength : DWORD* in/out
' wszExtendedInfoValue : LPWSTR optional, out
Declare PtrSafe Function DRMGetRightExtendedInfo Lib "msdrm" ( _
    ByVal hRight As Long, _
    ByVal uIndex As Long, _
    ByRef puExtendedInfoNameLength As Long, _
    ByVal wszExtendedInfoName As LongPtr, _
    ByRef puExtendedInfoValueLength As Long, _
    ByVal wszExtendedInfoValue As LongPtr) As Long
' VBA7前提(PtrSafe)。32bit Office では LongPtr→Long。Integer=16bit / Long=32bit / LongLong=64bit。

import ctypes
from ctypes import wintypes

DRMGetRightExtendedInfo = ctypes.windll.msdrm.DRMGetRightExtendedInfo
DRMGetRightExtendedInfo.restype = ctypes.c_int
DRMGetRightExtendedInfo.argtypes = [
    wintypes.DWORD,  # hRight : DWORD
    wintypes.DWORD,  # uIndex : DWORD
    ctypes.POINTER(wintypes.DWORD),  # puExtendedInfoNameLength : DWORD* in/out
    wintypes.LPWSTR,  # wszExtendedInfoName : LPWSTR optional, out
    ctypes.POINTER(wintypes.DWORD),  # puExtendedInfoValueLength : DWORD* in/out
    wintypes.LPWSTR,  # wszExtendedInfoValue : LPWSTR optional, out
]

require 'fiddle'
require 'fiddle/import'

lib = Fiddle.dlopen('msdrm.dll')
DRMGetRightExtendedInfo = Fiddle::Function.new(
  lib['DRMGetRightExtendedInfo'],
  [
    -Fiddle::TYPE_INT,  # hRight : DWORD
    -Fiddle::TYPE_INT,  # uIndex : DWORD
    Fiddle::TYPE_VOIDP,  # puExtendedInfoNameLength : DWORD* in/out
    Fiddle::TYPE_VOIDP,  # wszExtendedInfoName : LPWSTR optional, out
    Fiddle::TYPE_VOIDP,  # puExtendedInfoValueLength : DWORD* in/out
    Fiddle::TYPE_VOIDP,  # wszExtendedInfoValue : LPWSTR optional, out
  ],
  Fiddle::TYPE_INT)

#[link(name = "msdrm")]
extern "system" {
    fn DRMGetRightExtendedInfo(
        hRight: u32,  // DWORD
        uIndex: u32,  // DWORD
        puExtendedInfoNameLength: *mut u32,  // DWORD* in/out
        wszExtendedInfoName: *mut u16,  // LPWSTR optional, out
        puExtendedInfoValueLength: *mut u32,  // DWORD* in/out
        wszExtendedInfoValue: *mut u16  // LPWSTR optional, out
    ) -> i32;
}
// crates: windows-sys provides ready-made bindings for this API.

$sig = @"
[DllImport("msdrm.dll")]
public static extern int DRMGetRightExtendedInfo(uint hRight, uint uIndex, ref uint puExtendedInfoNameLength, [MarshalAs(UnmanagedType.LPWStr)] System.Text.StringBuilder wszExtendedInfoName, ref uint puExtendedInfoValueLength, [MarshalAs(UnmanagedType.LPWStr)] System.Text.StringBuilder wszExtendedInfoValue);
"@
$api = Add-Type -MemberDefinition $sig -Name 'msdrm_DRMGetRightExtendedInfo' -Namespace Win32 -PassThru
# $api::DRMGetRightExtendedInfo(hRight, uIndex, puExtendedInfoNameLength, wszExtendedInfoName, puExtendedInfoValueLength, wszExtendedInfoValue)

#uselib "msdrm.dll"
#func global DRMGetRightExtendedInfo "DRMGetRightExtendedInfo" sptr, sptr, sptr, sptr, sptr, sptr
; DRMGetRightExtendedInfo hRight, uIndex, varptr(puExtendedInfoNameLength), varptr(wszExtendedInfoName), varptr(puExtendedInfoValueLength), varptr(wszExtendedInfoValue)   ; 戻り値は stat
; hRight : DWORD -> "sptr"
; uIndex : DWORD -> "sptr"
; puExtendedInfoNameLength : DWORD* in/out -> "sptr"
; wszExtendedInfoName : LPWSTR optional, out -> "sptr"
; puExtendedInfoValueLength : DWORD* in/out -> "sptr"
; wszExtendedInfoValue : LPWSTR optional, out -> "sptr"
; ※HSP3.7は #func のため戻り値はシステム変数 stat に格納されます。

出力引数:

#uselib "msdrm.dll"
#cfunc global DRMGetRightExtendedInfo "DRMGetRightExtendedInfo" int, int, var, var, var, var
; res = DRMGetRightExtendedInfo(hRight, uIndex, puExtendedInfoNameLength, wszExtendedInfoName, puExtendedInfoValueLength, wszExtendedInfoValue)
; hRight : DWORD -> "int"
; uIndex : DWORD -> "int"
; puExtendedInfoNameLength : DWORD* in/out -> "var"
; wszExtendedInfoName : LPWSTR optional, out -> "var"
; puExtendedInfoValueLength : DWORD* in/out -> "var"
; wszExtendedInfoValue : LPWSTR optional, out -> "var"
; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。#uselib "msdrm.dll"
#cfunc global DRMGetRightExtendedInfo "DRMGetRightExtendedInfo" int, int, sptr, sptr, sptr, sptr
; res = DRMGetRightExtendedInfo(hRight, uIndex, varptr(puExtendedInfoNameLength), varptr(wszExtendedInfoName), varptr(puExtendedInfoValueLength), varptr(wszExtendedInfoValue))
; hRight : DWORD -> "int"
; uIndex : DWORD -> "int"
; puExtendedInfoNameLength : DWORD* in/out -> "sptr"
; wszExtendedInfoName : LPWSTR optional, out -> "sptr"
; puExtendedInfoValueLength : DWORD* in/out -> "sptr"
; wszExtendedInfoValue : LPWSTR optional, out -> "sptr"
; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。

出力引数:

; HRESULT DRMGetRightExtendedInfo(DWORD hRight, DWORD uIndex, DWORD* puExtendedInfoNameLength, LPWSTR wszExtendedInfoName, DWORD* puExtendedInfoValueLength, LPWSTR wszExtendedInfoValue)
#uselib "msdrm.dll"
#cfunc global DRMGetRightExtendedInfo "DRMGetRightExtendedInfo" int, int, var, var, var, var
; res = DRMGetRightExtendedInfo(hRight, uIndex, puExtendedInfoNameLength, wszExtendedInfoName, puExtendedInfoValueLength, wszExtendedInfoValue)
; hRight : DWORD -> "int"
; uIndex : DWORD -> "int"
; puExtendedInfoNameLength : DWORD* in/out -> "var"
; wszExtendedInfoName : LPWSTR optional, out -> "var"
; puExtendedInfoValueLength : DWORD* in/out -> "var"
; wszExtendedInfoValue : LPWSTR optional, out -> "var"
; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。; HRESULT DRMGetRightExtendedInfo(DWORD hRight, DWORD uIndex, DWORD* puExtendedInfoNameLength, LPWSTR wszExtendedInfoName, DWORD* puExtendedInfoValueLength, LPWSTR wszExtendedInfoValue)
#uselib "msdrm.dll"
#cfunc global DRMGetRightExtendedInfo "DRMGetRightExtendedInfo" int, int, intptr, intptr, intptr, intptr
; res = DRMGetRightExtendedInfo(hRight, uIndex, varptr(puExtendedInfoNameLength), varptr(wszExtendedInfoName), varptr(puExtendedInfoValueLength), varptr(wszExtendedInfoValue))
; hRight : DWORD -> "int"
; uIndex : DWORD -> "int"
; puExtendedInfoNameLength : DWORD* in/out -> "intptr"
; wszExtendedInfoName : LPWSTR optional, out -> "intptr"
; puExtendedInfoValueLength : DWORD* in/out -> "intptr"
; wszExtendedInfoValue : LPWSTR optional, out -> "intptr"
; ※出力/バッファ引数はポインタ方式(token=intptr / 呼び出しは varptr(変数))。

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

var (
	msdrm = windows.NewLazySystemDLL("msdrm.dll")
	procDRMGetRightExtendedInfo = msdrm.NewProc("DRMGetRightExtendedInfo")
)

// hRight (DWORD), uIndex (DWORD), puExtendedInfoNameLength (DWORD* in/out), wszExtendedInfoName (LPWSTR optional, out), puExtendedInfoValueLength (DWORD* in/out), wszExtendedInfoValue (LPWSTR optional, out)
r1, _, err := procDRMGetRightExtendedInfo.Call(
	uintptr(hRight),
	uintptr(uIndex),
	uintptr(puExtendedInfoNameLength),
	uintptr(wszExtendedInfoName),
	uintptr(puExtendedInfoValueLength),
	uintptr(wszExtendedInfoValue),
)
_ = err  // syscall.Errno (valid when the call sets last-error)
_ = r1   // HRESULT

function DRMGetRightExtendedInfo(
  hRight: DWORD;   // DWORD
  uIndex: DWORD;   // DWORD
  puExtendedInfoNameLength: Pointer;   // DWORD* in/out
  wszExtendedInfoName: PWideChar;   // LPWSTR optional, out
  puExtendedInfoValueLength: Pointer;   // DWORD* in/out
  wszExtendedInfoValue: PWideChar   // LPWSTR optional, out
): Integer; stdcall;
  external 'msdrm.dll' name 'DRMGetRightExtendedInfo';

result := DllCall("msdrm\DRMGetRightExtendedInfo"
    , "UInt", hRight   ; DWORD
    , "UInt", uIndex   ; DWORD
    , "Ptr", puExtendedInfoNameLength   ; DWORD* in/out
    , "Ptr", wszExtendedInfoName   ; LPWSTR optional, out
    , "Ptr", puExtendedInfoValueLength   ; DWORD* in/out
    , "Ptr", wszExtendedInfoValue   ; LPWSTR optional, out
    , "Int")   ; return: HRESULT

●DRMGetRightExtendedInfo(hRight, uIndex, puExtendedInfoNameLength, wszExtendedInfoName, puExtendedInfoValueLength, wszExtendedInfoValue) = DLL("msdrm.dll", "int DRMGetRightExtendedInfo(dword, dword, void*, char*, void*, char*)")
# 呼び出し: DRMGetRightExtendedInfo(hRight, uIndex, puExtendedInfoNameLength, wszExtendedInfoName, puExtendedInfoValueLength, wszExtendedInfoValue)
# hRight : DWORD -> "dword"
# uIndex : DWORD -> "dword"
# puExtendedInfoNameLength : DWORD* in/out -> "void*"
# wszExtendedInfoName : LPWSTR optional, out -> "char*"
# puExtendedInfoValueLength : DWORD* in/out -> "void*"
# wszExtendedInfoValue : LPWSTR optional, out -> "char*"
# なでしこ1は32bit・ANSI(Shift_JIS)。文字列=char*(ANSI)、ポインタ/ハンドル=void*(4byte)。