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

DRMGetMetaData

関数
発行ライセンスのコンテンツメタデータを取得する。
DLLmsdrm.dll呼出規約winapi

シグネチャ

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

HRESULT DRMGetMetaData(
    DWORD hIssuanceLicense,
    DWORD* puContentIdLength,
    LPWSTR wszContentId,   // optional
    DWORD* puContentIdTypeLength,
    LPWSTR wszContentIdType,   // optional
    DWORD* puSKUIdLength,
    LPWSTR wszSKUId,   // optional
    DWORD* puSKUIdTypeLength,
    LPWSTR wszSKUIdType,   // optional
    DWORD* puContentTypeLength,
    LPWSTR wszContentType,   // optional
    DWORD* puContentNameLength,
    LPWSTR wszContentName   // optional
);

パラメーター

名前方向
hIssuanceLicenseDWORDin
puContentIdLengthDWORD*inout
wszContentIdLPWSTRoutoptional
puContentIdTypeLengthDWORD*inout
wszContentIdTypeLPWSTRoutoptional
puSKUIdLengthDWORD*inout
wszSKUIdLPWSTRoutoptional
puSKUIdTypeLengthDWORD*inout
wszSKUIdTypeLPWSTRoutoptional
puContentTypeLengthDWORD*inout
wszContentTypeLPWSTRoutoptional
puContentNameLengthDWORD*inout
wszContentNameLPWSTRoutoptional

戻り値の型: HRESULT

各言語での呼び出し定義

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

HRESULT DRMGetMetaData(
    DWORD hIssuanceLicense,
    DWORD* puContentIdLength,
    LPWSTR wszContentId,   // optional
    DWORD* puContentIdTypeLength,
    LPWSTR wszContentIdType,   // optional
    DWORD* puSKUIdLength,
    LPWSTR wszSKUId,   // optional
    DWORD* puSKUIdTypeLength,
    LPWSTR wszSKUIdType,   // optional
    DWORD* puContentTypeLength,
    LPWSTR wszContentType,   // optional
    DWORD* puContentNameLength,
    LPWSTR wszContentName   // optional
);
[DllImport("msdrm.dll", ExactSpelling = true)]
static extern int DRMGetMetaData(
    uint hIssuanceLicense,   // DWORD
    ref uint puContentIdLength,   // DWORD* in/out
    [MarshalAs(UnmanagedType.LPWStr)] System.Text.StringBuilder wszContentId,   // LPWSTR optional, out
    ref uint puContentIdTypeLength,   // DWORD* in/out
    [MarshalAs(UnmanagedType.LPWStr)] System.Text.StringBuilder wszContentIdType,   // LPWSTR optional, out
    ref uint puSKUIdLength,   // DWORD* in/out
    [MarshalAs(UnmanagedType.LPWStr)] System.Text.StringBuilder wszSKUId,   // LPWSTR optional, out
    ref uint puSKUIdTypeLength,   // DWORD* in/out
    [MarshalAs(UnmanagedType.LPWStr)] System.Text.StringBuilder wszSKUIdType,   // LPWSTR optional, out
    ref uint puContentTypeLength,   // DWORD* in/out
    [MarshalAs(UnmanagedType.LPWStr)] System.Text.StringBuilder wszContentType,   // LPWSTR optional, out
    ref uint puContentNameLength,   // DWORD* in/out
    [MarshalAs(UnmanagedType.LPWStr)] System.Text.StringBuilder wszContentName   // LPWSTR optional, out
);
<DllImport("msdrm.dll", ExactSpelling:=True)>
Public Shared Function DRMGetMetaData(
    hIssuanceLicense As UInteger,   ' DWORD
    ByRef puContentIdLength As UInteger,   ' DWORD* in/out
    <MarshalAs(UnmanagedType.LPWStr)> wszContentId As System.Text.StringBuilder,   ' LPWSTR optional, out
    ByRef puContentIdTypeLength As UInteger,   ' DWORD* in/out
    <MarshalAs(UnmanagedType.LPWStr)> wszContentIdType As System.Text.StringBuilder,   ' LPWSTR optional, out
    ByRef puSKUIdLength As UInteger,   ' DWORD* in/out
    <MarshalAs(UnmanagedType.LPWStr)> wszSKUId As System.Text.StringBuilder,   ' LPWSTR optional, out
    ByRef puSKUIdTypeLength As UInteger,   ' DWORD* in/out
    <MarshalAs(UnmanagedType.LPWStr)> wszSKUIdType As System.Text.StringBuilder,   ' LPWSTR optional, out
    ByRef puContentTypeLength As UInteger,   ' DWORD* in/out
    <MarshalAs(UnmanagedType.LPWStr)> wszContentType As System.Text.StringBuilder,   ' LPWSTR optional, out
    ByRef puContentNameLength As UInteger,   ' DWORD* in/out
    <MarshalAs(UnmanagedType.LPWStr)> wszContentName As System.Text.StringBuilder   ' LPWSTR optional, out
) As Integer
End Function
' hIssuanceLicense : DWORD
' puContentIdLength : DWORD* in/out
' wszContentId : LPWSTR optional, out
' puContentIdTypeLength : DWORD* in/out
' wszContentIdType : LPWSTR optional, out
' puSKUIdLength : DWORD* in/out
' wszSKUId : LPWSTR optional, out
' puSKUIdTypeLength : DWORD* in/out
' wszSKUIdType : LPWSTR optional, out
' puContentTypeLength : DWORD* in/out
' wszContentType : LPWSTR optional, out
' puContentNameLength : DWORD* in/out
' wszContentName : LPWSTR optional, out
Declare PtrSafe Function DRMGetMetaData Lib "msdrm" ( _
    ByVal hIssuanceLicense As Long, _
    ByRef puContentIdLength As Long, _
    ByVal wszContentId As LongPtr, _
    ByRef puContentIdTypeLength As Long, _
    ByVal wszContentIdType As LongPtr, _
    ByRef puSKUIdLength As Long, _
    ByVal wszSKUId As LongPtr, _
    ByRef puSKUIdTypeLength As Long, _
    ByVal wszSKUIdType As LongPtr, _
    ByRef puContentTypeLength As Long, _
    ByVal wszContentType As LongPtr, _
    ByRef puContentNameLength As Long, _
    ByVal wszContentName As LongPtr) As Long
' VBA7前提(PtrSafe)。32bit Office では LongPtr→Long。Integer=16bit / Long=32bit / LongLong=64bit。
import ctypes
from ctypes import wintypes

DRMGetMetaData = ctypes.windll.msdrm.DRMGetMetaData
DRMGetMetaData.restype = ctypes.c_int
DRMGetMetaData.argtypes = [
    wintypes.DWORD,  # hIssuanceLicense : DWORD
    ctypes.POINTER(wintypes.DWORD),  # puContentIdLength : DWORD* in/out
    wintypes.LPWSTR,  # wszContentId : LPWSTR optional, out
    ctypes.POINTER(wintypes.DWORD),  # puContentIdTypeLength : DWORD* in/out
    wintypes.LPWSTR,  # wszContentIdType : LPWSTR optional, out
    ctypes.POINTER(wintypes.DWORD),  # puSKUIdLength : DWORD* in/out
    wintypes.LPWSTR,  # wszSKUId : LPWSTR optional, out
    ctypes.POINTER(wintypes.DWORD),  # puSKUIdTypeLength : DWORD* in/out
    wintypes.LPWSTR,  # wszSKUIdType : LPWSTR optional, out
    ctypes.POINTER(wintypes.DWORD),  # puContentTypeLength : DWORD* in/out
    wintypes.LPWSTR,  # wszContentType : LPWSTR optional, out
    ctypes.POINTER(wintypes.DWORD),  # puContentNameLength : DWORD* in/out
    wintypes.LPWSTR,  # wszContentName : LPWSTR optional, out
]
require 'fiddle'
require 'fiddle/import'

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

var (
	msdrm = windows.NewLazySystemDLL("msdrm.dll")
	procDRMGetMetaData = msdrm.NewProc("DRMGetMetaData")
)

// hIssuanceLicense (DWORD), puContentIdLength (DWORD* in/out), wszContentId (LPWSTR optional, out), puContentIdTypeLength (DWORD* in/out), wszContentIdType (LPWSTR optional, out), puSKUIdLength (DWORD* in/out), wszSKUId (LPWSTR optional, out), puSKUIdTypeLength (DWORD* in/out), wszSKUIdType (LPWSTR optional, out), puContentTypeLength (DWORD* in/out), wszContentType (LPWSTR optional, out), puContentNameLength (DWORD* in/out), wszContentName (LPWSTR optional, out)
r1, _, err := procDRMGetMetaData.Call(
	uintptr(hIssuanceLicense),
	uintptr(puContentIdLength),
	uintptr(wszContentId),
	uintptr(puContentIdTypeLength),
	uintptr(wszContentIdType),
	uintptr(puSKUIdLength),
	uintptr(wszSKUId),
	uintptr(puSKUIdTypeLength),
	uintptr(wszSKUIdType),
	uintptr(puContentTypeLength),
	uintptr(wszContentType),
	uintptr(puContentNameLength),
	uintptr(wszContentName),
)
_ = err  // syscall.Errno (valid when the call sets last-error)
_ = r1   // HRESULT
function DRMGetMetaData(
  hIssuanceLicense: DWORD;   // DWORD
  puContentIdLength: Pointer;   // DWORD* in/out
  wszContentId: PWideChar;   // LPWSTR optional, out
  puContentIdTypeLength: Pointer;   // DWORD* in/out
  wszContentIdType: PWideChar;   // LPWSTR optional, out
  puSKUIdLength: Pointer;   // DWORD* in/out
  wszSKUId: PWideChar;   // LPWSTR optional, out
  puSKUIdTypeLength: Pointer;   // DWORD* in/out
  wszSKUIdType: PWideChar;   // LPWSTR optional, out
  puContentTypeLength: Pointer;   // DWORD* in/out
  wszContentType: PWideChar;   // LPWSTR optional, out
  puContentNameLength: Pointer;   // DWORD* in/out
  wszContentName: PWideChar   // LPWSTR optional, out
): Integer; stdcall;
  external 'msdrm.dll' name 'DRMGetMetaData';
result := DllCall("msdrm\DRMGetMetaData"
    , "UInt", hIssuanceLicense   ; DWORD
    , "Ptr", puContentIdLength   ; DWORD* in/out
    , "Ptr", wszContentId   ; LPWSTR optional, out
    , "Ptr", puContentIdTypeLength   ; DWORD* in/out
    , "Ptr", wszContentIdType   ; LPWSTR optional, out
    , "Ptr", puSKUIdLength   ; DWORD* in/out
    , "Ptr", wszSKUId   ; LPWSTR optional, out
    , "Ptr", puSKUIdTypeLength   ; DWORD* in/out
    , "Ptr", wszSKUIdType   ; LPWSTR optional, out
    , "Ptr", puContentTypeLength   ; DWORD* in/out
    , "Ptr", wszContentType   ; LPWSTR optional, out
    , "Ptr", puContentNameLength   ; DWORD* in/out
    , "Ptr", wszContentName   ; LPWSTR optional, out
    , "Int")   ; return: HRESULT
●DRMGetMetaData(hIssuanceLicense, puContentIdLength, wszContentId, puContentIdTypeLength, wszContentIdType, puSKUIdLength, wszSKUId, puSKUIdTypeLength, wszSKUIdType, puContentTypeLength, wszContentType, puContentNameLength, wszContentName) = DLL("msdrm.dll", "int DRMGetMetaData(dword, void*, char*, void*, char*, void*, char*, void*, char*, void*, char*, void*, char*)")
# 呼び出し: DRMGetMetaData(hIssuanceLicense, puContentIdLength, wszContentId, puContentIdTypeLength, wszContentIdType, puSKUIdLength, wszSKUId, puSKUIdTypeLength, wszSKUIdType, puContentTypeLength, wszContentType, puContentNameLength, wszContentName)
# hIssuanceLicense : DWORD -> "dword"
# puContentIdLength : DWORD* in/out -> "void*"
# wszContentId : LPWSTR optional, out -> "char*"
# puContentIdTypeLength : DWORD* in/out -> "void*"
# wszContentIdType : LPWSTR optional, out -> "char*"
# puSKUIdLength : DWORD* in/out -> "void*"
# wszSKUId : LPWSTR optional, out -> "char*"
# puSKUIdTypeLength : DWORD* in/out -> "void*"
# wszSKUIdType : LPWSTR optional, out -> "char*"
# puContentTypeLength : DWORD* in/out -> "void*"
# wszContentType : LPWSTR optional, out -> "char*"
# puContentNameLength : DWORD* in/out -> "void*"
# wszContentName : LPWSTR optional, out -> "char*"
# なでしこ1は32bit・ANSI(Shift_JIS)。文字列=char*(ANSI)、ポインタ/ハンドル=void*(4byte)。