Win32 API 日本語リファレンス
ホームGraphics.Printing.PrintTicket › PTConvertPrintTicketToDevMode

PTConvertPrintTicketToDevMode

関数
プリントチケットをDEVMODEに変換する。
DLLprntvpt.dll呼出規約winapi対応OSWindows XP 以降

シグネチャ

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

HRESULT PTConvertPrintTicketToDevMode(
    HPTPROVIDER hProvider,
    IStream* pPrintTicket,
    EDefaultDevmodeType baseDevmodeType,
    EPrintTicketScope scope,
    DWORD* pcbDevmode,
    DEVMODEA** ppDevmode,
    LPWSTR* pbstrErrorMessage   // optional
);

パラメーター

名前方向
hProviderHPTPROVIDERin
pPrintTicketIStream*in
baseDevmodeTypeEDefaultDevmodeTypein
scopeEPrintTicketScopein
pcbDevmodeDWORD*out
ppDevmodeDEVMODEA**out
pbstrErrorMessageLPWSTR*outoptional

戻り値の型: HRESULT

各言語での呼び出し定義

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

HRESULT PTConvertPrintTicketToDevMode(
    HPTPROVIDER hProvider,
    IStream* pPrintTicket,
    EDefaultDevmodeType baseDevmodeType,
    EPrintTicketScope scope,
    DWORD* pcbDevmode,
    DEVMODEA** ppDevmode,
    LPWSTR* pbstrErrorMessage   // optional
);
[DllImport("prntvpt.dll", ExactSpelling = true)]
static extern int PTConvertPrintTicketToDevMode(
    IntPtr hProvider,   // HPTPROVIDER
    IntPtr pPrintTicket,   // IStream*
    int baseDevmodeType,   // EDefaultDevmodeType
    int scope,   // EPrintTicketScope
    out uint pcbDevmode,   // DWORD* out
    IntPtr ppDevmode,   // DEVMODEA** out
    IntPtr pbstrErrorMessage   // LPWSTR* optional, out
);
<DllImport("prntvpt.dll", ExactSpelling:=True)>
Public Shared Function PTConvertPrintTicketToDevMode(
    hProvider As IntPtr,   ' HPTPROVIDER
    pPrintTicket As IntPtr,   ' IStream*
    baseDevmodeType As Integer,   ' EDefaultDevmodeType
    scope As Integer,   ' EPrintTicketScope
    <Out> ByRef pcbDevmode As UInteger,   ' DWORD* out
    ppDevmode As IntPtr,   ' DEVMODEA** out
    pbstrErrorMessage As IntPtr   ' LPWSTR* optional, out
) As Integer
End Function
' hProvider : HPTPROVIDER
' pPrintTicket : IStream*
' baseDevmodeType : EDefaultDevmodeType
' scope : EPrintTicketScope
' pcbDevmode : DWORD* out
' ppDevmode : DEVMODEA** out
' pbstrErrorMessage : LPWSTR* optional, out
Declare PtrSafe Function PTConvertPrintTicketToDevMode Lib "prntvpt" ( _
    ByVal hProvider As LongPtr, _
    ByVal pPrintTicket As LongPtr, _
    ByVal baseDevmodeType As Long, _
    ByVal scope As Long, _
    ByRef pcbDevmode As Long, _
    ByVal ppDevmode As LongPtr, _
    ByVal pbstrErrorMessage As LongPtr) As Long
' VBA7前提(PtrSafe)。32bit Office では LongPtr→Long。Integer=16bit / Long=32bit / LongLong=64bit。
import ctypes
from ctypes import wintypes

PTConvertPrintTicketToDevMode = ctypes.windll.prntvpt.PTConvertPrintTicketToDevMode
PTConvertPrintTicketToDevMode.restype = ctypes.c_int
PTConvertPrintTicketToDevMode.argtypes = [
    wintypes.HANDLE,  # hProvider : HPTPROVIDER
    ctypes.c_void_p,  # pPrintTicket : IStream*
    ctypes.c_int,  # baseDevmodeType : EDefaultDevmodeType
    ctypes.c_int,  # scope : EPrintTicketScope
    ctypes.POINTER(wintypes.DWORD),  # pcbDevmode : DWORD* out
    ctypes.c_void_p,  # ppDevmode : DEVMODEA** out
    ctypes.c_void_p,  # pbstrErrorMessage : LPWSTR* optional, out
]
require 'fiddle'
require 'fiddle/import'

lib = Fiddle.dlopen('prntvpt.dll')
PTConvertPrintTicketToDevMode = Fiddle::Function.new(
  lib['PTConvertPrintTicketToDevMode'],
  [
    Fiddle::TYPE_VOIDP,  # hProvider : HPTPROVIDER
    Fiddle::TYPE_VOIDP,  # pPrintTicket : IStream*
    Fiddle::TYPE_INT,  # baseDevmodeType : EDefaultDevmodeType
    Fiddle::TYPE_INT,  # scope : EPrintTicketScope
    Fiddle::TYPE_VOIDP,  # pcbDevmode : DWORD* out
    Fiddle::TYPE_VOIDP,  # ppDevmode : DEVMODEA** out
    Fiddle::TYPE_VOIDP,  # pbstrErrorMessage : LPWSTR* optional, out
  ],
  Fiddle::TYPE_INT)
#[link(name = "prntvpt")]
extern "system" {
    fn PTConvertPrintTicketToDevMode(
        hProvider: *mut core::ffi::c_void,  // HPTPROVIDER
        pPrintTicket: *mut core::ffi::c_void,  // IStream*
        baseDevmodeType: i32,  // EDefaultDevmodeType
        scope: i32,  // EPrintTicketScope
        pcbDevmode: *mut u32,  // DWORD* out
        ppDevmode: *mut *mut DEVMODEA,  // DEVMODEA** out
        pbstrErrorMessage: *mut *mut u16  // LPWSTR* optional, out
    ) -> i32;
}
// crates: windows-sys provides ready-made bindings for this API.
$sig = @"
[DllImport("prntvpt.dll")]
public static extern int PTConvertPrintTicketToDevMode(IntPtr hProvider, IntPtr pPrintTicket, int baseDevmodeType, int scope, out uint pcbDevmode, IntPtr ppDevmode, IntPtr pbstrErrorMessage);
"@
$api = Add-Type -MemberDefinition $sig -Name 'prntvpt_PTConvertPrintTicketToDevMode' -Namespace Win32 -PassThru
# $api::PTConvertPrintTicketToDevMode(hProvider, pPrintTicket, baseDevmodeType, scope, pcbDevmode, ppDevmode, pbstrErrorMessage)
#uselib "prntvpt.dll"
#func global PTConvertPrintTicketToDevMode "PTConvertPrintTicketToDevMode" sptr, sptr, sptr, sptr, sptr, sptr, sptr
; PTConvertPrintTicketToDevMode hProvider, pPrintTicket, baseDevmodeType, scope, varptr(pcbDevmode), varptr(ppDevmode), varptr(pbstrErrorMessage)   ; 戻り値は stat
; hProvider : HPTPROVIDER -> "sptr"
; pPrintTicket : IStream* -> "sptr"
; baseDevmodeType : EDefaultDevmodeType -> "sptr"
; scope : EPrintTicketScope -> "sptr"
; pcbDevmode : DWORD* out -> "sptr"
; ppDevmode : DEVMODEA** out -> "sptr"
; pbstrErrorMessage : LPWSTR* optional, out -> "sptr"
; ※HSP3.7は #func のため戻り値はシステム変数 stat に格納されます。
出力引数:
#uselib "prntvpt.dll"
#cfunc global PTConvertPrintTicketToDevMode "PTConvertPrintTicketToDevMode" sptr, sptr, int, int, var, var, var
; res = PTConvertPrintTicketToDevMode(hProvider, pPrintTicket, baseDevmodeType, scope, pcbDevmode, ppDevmode, pbstrErrorMessage)
; hProvider : HPTPROVIDER -> "sptr"
; pPrintTicket : IStream* -> "sptr"
; baseDevmodeType : EDefaultDevmodeType -> "int"
; scope : EPrintTicketScope -> "int"
; pcbDevmode : DWORD* out -> "var"
; ppDevmode : DEVMODEA** out -> "var"
; pbstrErrorMessage : LPWSTR* optional, out -> "var"
; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。
出力引数:
; HRESULT PTConvertPrintTicketToDevMode(HPTPROVIDER hProvider, IStream* pPrintTicket, EDefaultDevmodeType baseDevmodeType, EPrintTicketScope scope, DWORD* pcbDevmode, DEVMODEA** ppDevmode, LPWSTR* pbstrErrorMessage)
#uselib "prntvpt.dll"
#cfunc global PTConvertPrintTicketToDevMode "PTConvertPrintTicketToDevMode" intptr, intptr, int, int, var, var, var
; res = PTConvertPrintTicketToDevMode(hProvider, pPrintTicket, baseDevmodeType, scope, pcbDevmode, ppDevmode, pbstrErrorMessage)
; hProvider : HPTPROVIDER -> "intptr"
; pPrintTicket : IStream* -> "intptr"
; baseDevmodeType : EDefaultDevmodeType -> "int"
; scope : EPrintTicketScope -> "int"
; pcbDevmode : DWORD* out -> "var"
; ppDevmode : DEVMODEA** out -> "var"
; pbstrErrorMessage : LPWSTR* optional, out -> "var"
; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。
import (
	"golang.org/x/sys/windows"
	"unsafe"
)

var (
	prntvpt = windows.NewLazySystemDLL("prntvpt.dll")
	procPTConvertPrintTicketToDevMode = prntvpt.NewProc("PTConvertPrintTicketToDevMode")
)

// hProvider (HPTPROVIDER), pPrintTicket (IStream*), baseDevmodeType (EDefaultDevmodeType), scope (EPrintTicketScope), pcbDevmode (DWORD* out), ppDevmode (DEVMODEA** out), pbstrErrorMessage (LPWSTR* optional, out)
r1, _, err := procPTConvertPrintTicketToDevMode.Call(
	uintptr(hProvider),
	uintptr(pPrintTicket),
	uintptr(baseDevmodeType),
	uintptr(scope),
	uintptr(pcbDevmode),
	uintptr(ppDevmode),
	uintptr(pbstrErrorMessage),
)
_ = err  // syscall.Errno (valid when the call sets last-error)
_ = r1   // HRESULT
function PTConvertPrintTicketToDevMode(
  hProvider: THandle;   // HPTPROVIDER
  pPrintTicket: Pointer;   // IStream*
  baseDevmodeType: Integer;   // EDefaultDevmodeType
  scope: Integer;   // EPrintTicketScope
  pcbDevmode: Pointer;   // DWORD* out
  ppDevmode: Pointer;   // DEVMODEA** out
  pbstrErrorMessage: PPWideChar   // LPWSTR* optional, out
): Integer; stdcall;
  external 'prntvpt.dll' name 'PTConvertPrintTicketToDevMode';
result := DllCall("prntvpt\PTConvertPrintTicketToDevMode"
    , "Ptr", hProvider   ; HPTPROVIDER
    , "Ptr", pPrintTicket   ; IStream*
    , "Int", baseDevmodeType   ; EDefaultDevmodeType
    , "Int", scope   ; EPrintTicketScope
    , "Ptr", pcbDevmode   ; DWORD* out
    , "Ptr", ppDevmode   ; DEVMODEA** out
    , "Ptr", pbstrErrorMessage   ; LPWSTR* optional, out
    , "Int")   ; return: HRESULT
●PTConvertPrintTicketToDevMode(hProvider, pPrintTicket, baseDevmodeType, scope, pcbDevmode, ppDevmode, pbstrErrorMessage) = DLL("prntvpt.dll", "int PTConvertPrintTicketToDevMode(void*, void*, int, int, void*, void*, void*)")
# 呼び出し: PTConvertPrintTicketToDevMode(hProvider, pPrintTicket, baseDevmodeType, scope, pcbDevmode, ppDevmode, pbstrErrorMessage)
# hProvider : HPTPROVIDER -> "void*"
# pPrintTicket : IStream* -> "void*"
# baseDevmodeType : EDefaultDevmodeType -> "int"
# scope : EPrintTicketScope -> "int"
# pcbDevmode : DWORD* out -> "void*"
# ppDevmode : DEVMODEA** out -> "void*"
# pbstrErrorMessage : LPWSTR* optional, out -> "void*"
# なでしこ1は32bit・ANSI(Shift_JIS)。文字列=char*(ANSI)、ポインタ/ハンドル=void*(4byte)。