ホーム › Data.RightsManagement › DRMGetIssuanceLicenseInfo

DRMGetIssuanceLicenseInfo

関数

発行ライセンスの各種情報を取得する。

DLLmsdrm.dll呼出規約winapi

シグネチャ

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

HRESULT DRMGetIssuanceLicenseInfo(
    DWORD hIssuanceLicense,
    SYSTEMTIME* pstTimeFrom,
    SYSTEMTIME* pstTimeUntil,
    DWORD uFlags,
    DWORD* puDistributionPointNameLength,
    LPWSTR wszDistributionPointName,   // optional
    DWORD* puDistributionPointURLLength,
    LPWSTR wszDistributionPointURL,   // optional
    DWORD* phOwner,
    BOOL* pfOfficial
);

パラメーター

名前	型	方向	説明
hIssuanceLicense	DWORD	in	情報の取得元となる発行ライセンスのハンドル。
pstTimeFrom	SYSTEMTIME*	inout	ライセンスの有効期間の開始時刻を UTC 時刻で受け取る SYSTEMTIME 構造体へのポインター。この情報が不要な場合は、このパラメーターに NULL を設定します。
pstTimeUntil	SYSTEMTIME*	inout	ライセンスの有効期間の終了時刻を UTC 時刻で受け取る SYSTEMTIME 構造体へのポインター。この情報が不要な場合は、このパラメーターに NULL を設定します。
uFlags	DWORD	in	この配布ポイントが提供するサービスの種類 (発行やライセンス取得など) を指定する DRM_DISTRIBUTION_POINT_INFO 列挙型の値。指定できるフラグは 1 つだけです。
puDistributionPointNameLength	DWORD*	inout	呼び出し時に wszDistributionPointName バッファーの長さ (文字数) を格納する UINT 値へのポインター。このサイズには終端の null 文字を含める必要があります。関数から戻ると、この値には wszDistributionPointName バッファーにコピーされた文字数 (終端の null 文字を含む) が格納されます。 wszDistributionPointName 文字列が不要な場合は、このパラメーターに NULL を設定します。
wszDistributionPointName	LPWSTR	outoptional	エンドユーザーライセンスを配布できる Web サイトの名前を受け取る、null で終わる Unicode 文字列へのポインター。このバッファーのサイズは puDistributionPointNameLength パラメーターで指定します。このバッファーに必要なサイズを確認するには、このパラメーターに NULL を渡します。関数は、終端の null 文字を含む文字数単位のサイズを puDistributionPointNameLength の値に格納します。
puDistributionPointURLLength	DWORD*	inout	呼び出し時に wszDistributionPointURL バッファーの長さ (文字数) を格納する UINT 値へのポインター。このサイズには終端の null 文字を含める必要があります。関数から戻ると、この値には wszDistributionPointURL バッファーにコピーされた文字数 (終端の null 文字を含む) が格納されます。 wszDistributionPointURL 文字列が不要な場合は、このパラメーターに NULL を設定します。
wszDistributionPointURL	LPWSTR	outoptional	エンドユーザーライセンスを配布できる Web サイトの URL を受け取る、null で終わる Unicode 文字列へのポインター。このバッファーのサイズは puDistributionPointURLLength パラメーターで指定します。このバッファーに必要なサイズを確認するには、このパラメーターに NULL を渡します。関数は、終端の null 文字を含む文字数単位のサイズを puDistributionPointURLLength の値に格納します。
phOwner	DWORD*	inout	発行ライセンスの所有者のハンドルを受け取る DRMPUBHANDLE 値へのポインター。この情報が不要な場合は、このパラメーターに NULL を設定します。ハンドルを閉じるには DRMClosePubHandle を呼び出します。
pfOfficial	BOOL*	inout	発行ライセンスが公式テンプレートに基づいているかどうかを示す Boolean 値へのポインター。0 以外の値は、そのライセンスが公式テンプレートに基づいていることを示します。公式テンプレートは AD RMS サーバーによって作成および署名されます。非公式テンプレートは、クライアントが新規に作成するか、公式テンプレートを変更して作成します。この情報が不要な場合は、このパラメーターに NULL を設定します。詳細については、Creating a License From a Template を参照してください。

戻り値の型: HRESULT

公式ドキュメント

発行ライセンスからさまざまな情報を取得します。

戻り値

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

関数が失敗した場合は、エラーを示す HRESULT 値を返します。一般的なエラーコードの一覧については、Common HRESULT Values を参照してください。

解説(Remarks)

出力パラメーターのメモリの割り当てと解放は、呼び出し元の関数が行います。これらの値を格納するために必要なバッファーサイズを確認するには、まず wszDistributionPointName と wszDistributionPointURL に NULL を指定してこの関数を呼び出し、長さパラメーター puDistributionPointNameLength および puDistributionPointURLLength から必要なサイズを取得します。

この関数の呼び出しによって作成されたライセンス所有者のハンドルを閉じるには、DRMClosePubHandle を呼び出します。

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

各言語での呼び出し定義

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

HRESULT DRMGetIssuanceLicenseInfo(
    DWORD hIssuanceLicense,
    SYSTEMTIME* pstTimeFrom,
    SYSTEMTIME* pstTimeUntil,
    DWORD uFlags,
    DWORD* puDistributionPointNameLength,
    LPWSTR wszDistributionPointName,   // optional
    DWORD* puDistributionPointURLLength,
    LPWSTR wszDistributionPointURL,   // optional
    DWORD* phOwner,
    BOOL* pfOfficial
);

[DllImport("msdrm.dll", ExactSpelling = true)]
static extern int DRMGetIssuanceLicenseInfo(
    uint hIssuanceLicense,   // DWORD
    IntPtr pstTimeFrom,   // SYSTEMTIME* in/out
    IntPtr pstTimeUntil,   // SYSTEMTIME* in/out
    uint uFlags,   // DWORD
    ref uint puDistributionPointNameLength,   // DWORD* in/out
    [MarshalAs(UnmanagedType.LPWStr)] System.Text.StringBuilder wszDistributionPointName,   // LPWSTR optional, out
    ref uint puDistributionPointURLLength,   // DWORD* in/out
    [MarshalAs(UnmanagedType.LPWStr)] System.Text.StringBuilder wszDistributionPointURL,   // LPWSTR optional, out
    ref uint phOwner,   // DWORD* in/out
    ref bool pfOfficial   // BOOL* in/out
);

<DllImport("msdrm.dll", ExactSpelling:=True)>
Public Shared Function DRMGetIssuanceLicenseInfo(
    hIssuanceLicense As UInteger,   ' DWORD
    pstTimeFrom As IntPtr,   ' SYSTEMTIME* in/out
    pstTimeUntil As IntPtr,   ' SYSTEMTIME* in/out
    uFlags As UInteger,   ' DWORD
    ByRef puDistributionPointNameLength As UInteger,   ' DWORD* in/out
    <MarshalAs(UnmanagedType.LPWStr)> wszDistributionPointName As System.Text.StringBuilder,   ' LPWSTR optional, out
    ByRef puDistributionPointURLLength As UInteger,   ' DWORD* in/out
    <MarshalAs(UnmanagedType.LPWStr)> wszDistributionPointURL As System.Text.StringBuilder,   ' LPWSTR optional, out
    ByRef phOwner As UInteger,   ' DWORD* in/out
    ByRef pfOfficial As Boolean   ' BOOL* in/out
) As Integer
End Function

' hIssuanceLicense : DWORD
' pstTimeFrom : SYSTEMTIME* in/out
' pstTimeUntil : SYSTEMTIME* in/out
' uFlags : DWORD
' puDistributionPointNameLength : DWORD* in/out
' wszDistributionPointName : LPWSTR optional, out
' puDistributionPointURLLength : DWORD* in/out
' wszDistributionPointURL : LPWSTR optional, out
' phOwner : DWORD* in/out
' pfOfficial : BOOL* in/out
Declare PtrSafe Function DRMGetIssuanceLicenseInfo Lib "msdrm" ( _
    ByVal hIssuanceLicense As Long, _
    ByVal pstTimeFrom As LongPtr, _
    ByVal pstTimeUntil As LongPtr, _
    ByVal uFlags As Long, _
    ByRef puDistributionPointNameLength As Long, _
    ByVal wszDistributionPointName As LongPtr, _
    ByRef puDistributionPointURLLength As Long, _
    ByVal wszDistributionPointURL As LongPtr, _
    ByRef phOwner As Long, _
    ByRef pfOfficial As Long) As Long
' VBA7前提(PtrSafe)。32bit Office では LongPtr→Long。Integer=16bit / Long=32bit / LongLong=64bit。

import ctypes
from ctypes import wintypes

DRMGetIssuanceLicenseInfo = ctypes.windll.msdrm.DRMGetIssuanceLicenseInfo
DRMGetIssuanceLicenseInfo.restype = ctypes.c_int
DRMGetIssuanceLicenseInfo.argtypes = [
    wintypes.DWORD,  # hIssuanceLicense : DWORD
    ctypes.c_void_p,  # pstTimeFrom : SYSTEMTIME* in/out
    ctypes.c_void_p,  # pstTimeUntil : SYSTEMTIME* in/out
    wintypes.DWORD,  # uFlags : DWORD
    ctypes.POINTER(wintypes.DWORD),  # puDistributionPointNameLength : DWORD* in/out
    wintypes.LPWSTR,  # wszDistributionPointName : LPWSTR optional, out
    ctypes.POINTER(wintypes.DWORD),  # puDistributionPointURLLength : DWORD* in/out
    wintypes.LPWSTR,  # wszDistributionPointURL : LPWSTR optional, out
    ctypes.POINTER(wintypes.DWORD),  # phOwner : DWORD* in/out
    ctypes.c_void_p,  # pfOfficial : BOOL* in/out
]

require 'fiddle'
require 'fiddle/import'

lib = Fiddle.dlopen('msdrm.dll')
DRMGetIssuanceLicenseInfo = Fiddle::Function.new(
  lib['DRMGetIssuanceLicenseInfo'],
  [
    -Fiddle::TYPE_INT,  # hIssuanceLicense : DWORD
    Fiddle::TYPE_VOIDP,  # pstTimeFrom : SYSTEMTIME* in/out
    Fiddle::TYPE_VOIDP,  # pstTimeUntil : SYSTEMTIME* in/out
    -Fiddle::TYPE_INT,  # uFlags : DWORD
    Fiddle::TYPE_VOIDP,  # puDistributionPointNameLength : DWORD* in/out
    Fiddle::TYPE_VOIDP,  # wszDistributionPointName : LPWSTR optional, out
    Fiddle::TYPE_VOIDP,  # puDistributionPointURLLength : DWORD* in/out
    Fiddle::TYPE_VOIDP,  # wszDistributionPointURL : LPWSTR optional, out
    Fiddle::TYPE_VOIDP,  # phOwner : DWORD* in/out
    Fiddle::TYPE_VOIDP,  # pfOfficial : BOOL* in/out
  ],
  Fiddle::TYPE_INT)

#[link(name = "msdrm")]
extern "system" {
    fn DRMGetIssuanceLicenseInfo(
        hIssuanceLicense: u32,  // DWORD
        pstTimeFrom: *mut SYSTEMTIME,  // SYSTEMTIME* in/out
        pstTimeUntil: *mut SYSTEMTIME,  // SYSTEMTIME* in/out
        uFlags: u32,  // DWORD
        puDistributionPointNameLength: *mut u32,  // DWORD* in/out
        wszDistributionPointName: *mut u16,  // LPWSTR optional, out
        puDistributionPointURLLength: *mut u32,  // DWORD* in/out
        wszDistributionPointURL: *mut u16,  // LPWSTR optional, out
        phOwner: *mut u32,  // DWORD* in/out
        pfOfficial: *mut i32  // BOOL* in/out
    ) -> i32;
}
// crates: windows-sys provides ready-made bindings for this API.

$sig = @"
[DllImport("msdrm.dll")]
public static extern int DRMGetIssuanceLicenseInfo(uint hIssuanceLicense, IntPtr pstTimeFrom, IntPtr pstTimeUntil, uint uFlags, ref uint puDistributionPointNameLength, [MarshalAs(UnmanagedType.LPWStr)] System.Text.StringBuilder wszDistributionPointName, ref uint puDistributionPointURLLength, [MarshalAs(UnmanagedType.LPWStr)] System.Text.StringBuilder wszDistributionPointURL, ref uint phOwner, ref bool pfOfficial);
"@
$api = Add-Type -MemberDefinition $sig -Name 'msdrm_DRMGetIssuanceLicenseInfo' -Namespace Win32 -PassThru
# $api::DRMGetIssuanceLicenseInfo(hIssuanceLicense, pstTimeFrom, pstTimeUntil, uFlags, puDistributionPointNameLength, wszDistributionPointName, puDistributionPointURLLength, wszDistributionPointURL, phOwner, pfOfficial)

#uselib "msdrm.dll"
#func global DRMGetIssuanceLicenseInfo "DRMGetIssuanceLicenseInfo" sptr, sptr, sptr, sptr, sptr, sptr, sptr, sptr, sptr, sptr
; DRMGetIssuanceLicenseInfo hIssuanceLicense, varptr(pstTimeFrom), varptr(pstTimeUntil), uFlags, varptr(puDistributionPointNameLength), varptr(wszDistributionPointName), varptr(puDistributionPointURLLength), varptr(wszDistributionPointURL), varptr(phOwner), varptr(pfOfficial)   ; 戻り値は stat
; hIssuanceLicense : DWORD -> "sptr"
; pstTimeFrom : SYSTEMTIME* in/out -> "sptr"
; pstTimeUntil : SYSTEMTIME* in/out -> "sptr"
; uFlags : DWORD -> "sptr"
; puDistributionPointNameLength : DWORD* in/out -> "sptr"
; wszDistributionPointName : LPWSTR optional, out -> "sptr"
; puDistributionPointURLLength : DWORD* in/out -> "sptr"
; wszDistributionPointURL : LPWSTR optional, out -> "sptr"
; phOwner : DWORD* in/out -> "sptr"
; pfOfficial : BOOL* in/out -> "sptr"
; ※HSP3.7は #func のため戻り値はシステム変数 stat に格納されます。

出力引数:

#uselib "msdrm.dll"
#cfunc global DRMGetIssuanceLicenseInfo "DRMGetIssuanceLicenseInfo" int, var, var, int, var, var, var, var, var, var
; res = DRMGetIssuanceLicenseInfo(hIssuanceLicense, pstTimeFrom, pstTimeUntil, uFlags, puDistributionPointNameLength, wszDistributionPointName, puDistributionPointURLLength, wszDistributionPointURL, phOwner, pfOfficial)
; hIssuanceLicense : DWORD -> "int"
; pstTimeFrom : SYSTEMTIME* in/out -> "var"
; pstTimeUntil : SYSTEMTIME* in/out -> "var"
; uFlags : DWORD -> "int"
; puDistributionPointNameLength : DWORD* in/out -> "var"
; wszDistributionPointName : LPWSTR optional, out -> "var"
; puDistributionPointURLLength : DWORD* in/out -> "var"
; wszDistributionPointURL : LPWSTR optional, out -> "var"
; phOwner : DWORD* in/out -> "var"
; pfOfficial : BOOL* in/out -> "var"
; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。#uselib "msdrm.dll"
#cfunc global DRMGetIssuanceLicenseInfo "DRMGetIssuanceLicenseInfo" int, sptr, sptr, int, sptr, sptr, sptr, sptr, sptr, sptr
; res = DRMGetIssuanceLicenseInfo(hIssuanceLicense, varptr(pstTimeFrom), varptr(pstTimeUntil), uFlags, varptr(puDistributionPointNameLength), varptr(wszDistributionPointName), varptr(puDistributionPointURLLength), varptr(wszDistributionPointURL), varptr(phOwner), varptr(pfOfficial))
; hIssuanceLicense : DWORD -> "int"
; pstTimeFrom : SYSTEMTIME* in/out -> "sptr"
; pstTimeUntil : SYSTEMTIME* in/out -> "sptr"
; uFlags : DWORD -> "int"
; puDistributionPointNameLength : DWORD* in/out -> "sptr"
; wszDistributionPointName : LPWSTR optional, out -> "sptr"
; puDistributionPointURLLength : DWORD* in/out -> "sptr"
; wszDistributionPointURL : LPWSTR optional, out -> "sptr"
; phOwner : DWORD* in/out -> "sptr"
; pfOfficial : BOOL* in/out -> "sptr"
; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。