ホーム › 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
);

パラメーター

名前	型	方向	説明
hRight	DWORD	in	情報を取得する対象の right のハンドル。
puRightNameLength	DWORD*	inout	UINT 値へのポインター。呼び出し時には、wszRightName バッファーの長さを文字数で指定します。この長さには終端の null 文字を含める必要があります。関数から制御が返ると、この値には wszRightName バッファーにコピーされた文字数 (終端の null 文字を含む) が格納されます。
wszRightName	LPWSTR	outoptional	right の名前を受け取る、null で終わる Unicode 文字列へのポインター。このバッファーのサイズは puRightNameLength パラメーターで指定します。この情報が不要な場合は、このパラメーターに NULL を設定します。このバッファーに必要なサイズを調べるには、このパラメーターに NULL を渡します。関数は、終端の null 文字を含む必要なサイズを文字数で puRightNameLength の値に格納します。
pstFrom	SYSTEMTIME*	inout	right の有効期間の開始日時を UTC 時刻で受け取る SYSTEMTIME 構造体へのポインター。この情報が不要な場合は、このパラメーターに NULL を設定します。
pstUntil	SYSTEMTIME*	inout	right の有効期間の終了日時を UTC 時刻で受け取る SYSTEMTIME 構造体へのポインター。この情報が不要な場合は、このパラメーターに NULL を設定します。

戻り値の型: HRESULT

公式ドキュメント

以前に作成された right (権利) に関する情報を取得します。

戻り値

関数が成功した場合、S_OK を返します。

関数が失敗した場合は、エラーを示す HRESULT 値を返します。返される可能性のある値には、次の一覧に示すものが含まれますが、これらに限定されません。一般的なエラーコードの一覧については、「Common HRESULT Values」を参照してください。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

各言語での呼び出し定義

// 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 方式にも切替可。#uselib "msdrm.dll"
#cfunc global DRMGetRightInfo "DRMGetRightInfo" int, sptr, sptr, sptr, sptr
; res = DRMGetRightInfo(hRight, varptr(puRightNameLength), varptr(wszRightName), varptr(pstFrom), varptr(pstUntil))
; hRight : DWORD -> "int"
; puRightNameLength : DWORD* in/out -> "sptr"
; wszRightName : LPWSTR optional, out -> "sptr"
; pstFrom : SYSTEMTIME* in/out -> "sptr"
; pstUntil : SYSTEMTIME* in/out -> "sptr"
; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。