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

PRINTER_INFO_5A

構造体
サイズx64: 32 バイト / x86: 20 バイト

サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。

フィールド

フィールドサイズx64x86説明
pPrinterNameLPSTR8/4+0+0プリンタ名(ANSI)へのポインタ。
pPortNameLPSTR8/4+8+4出力先ポート名(ANSI)。複数ポートはカンマ区切り。
AttributesDWORD4+16+8プリンタ属性を示すビットフラグ(PRINTER_ATTRIBUTE_*)。
DeviceNotSelectedTimeoutDWORD4+20+12デバイス未選択時のタイムアウト(ミリ秒)。
TransmissionRetryTimeoutDWORD4+24+16送信再試行のタイムアウト(ミリ秒)。

公式ドキュメント

PRINTER_INFO_5 構造体は、プリンターの詳細情報を指定します。

解説(Remarks)

pPrinterName

プリンターの名前を指定する、null で終わる文字列へのポインターです。

pPortName

プリンターへデータを送信するために使用するポートを識別する、null で終わる文字列へのポインターです。プリンターが複数のポートに接続されている場合、各ポートの名前はカンマで区切る必要があります (たとえば "LPT1:,LPT2:,LPT3:")。

Attributes

プリンターの属性です。このメンバーには、次の値の妥当な組み合わせを指定できます。

意味
PRINTER_ATTRIBUTE_DIRECT ジョブはスプールされず、プリンターへ直接送信されます。
PRINTER_ATTRIBUTE_DO_COMPLETE_FIRST この値が設定されており、プリンターがスプール中の印刷に設定されている場合、スプールが完了したジョブは、スプールが完了していないジョブより先に印刷されるようスケジュールされます。
PRINTER_ATTRIBUTE_ENABLE_DEVQ 設定されている場合、DevQueryPrint が呼び出されます。ドキュメントとプリンターの設定が一致しない場合、DevQueryPrint は失敗することがあります。このフラグを設定すると、一致しないドキュメントはキューに保持されます。
PRINTER_ATTRIBUTE_HIDDEN 予約済みです。
PRINTER_ATTRIBUTE_KEEPPRINTEDJOBS 設定されている場合、ジョブは印刷後も保持されます。設定されていない場合、ジョブは削除されます。
PRINTER_ATTRIBUTE_LOCAL プリンターはローカルプリンターです。
PRINTER_ATTRIBUTE_NETWORK プリンターはネットワークプリンター接続です。
PRINTER_ATTRIBUTE_PUBLISHED プリンターがディレクトリサービスに公開されているかどうかを示します。
PRINTER_ATTRIBUTE_QUEUED 設定されている場合、プリンターはスプールを行い、最後のページがスプールされた後に印刷を開始します。設定されておらず、PRINTER_ATTRIBUTE_DIRECT も設定されていない場合、プリンターはスプールしながら印刷します。
PRINTER_ATTRIBUTE_RAW_ONLY raw データ型の印刷ジョブのみをスプールできることを示します。
PRINTER_ATTRIBUTE_SHARED プリンターは共有されています。

Windows XP 以降のバージョンの Windows では、次の値も使用できます。

意味
PRINTER_ATTRIBUTE_FAX 設定されている場合、プリンターは FAX プリンターです。これは AddPrinter でのみ設定できますが、EnumPrinters および GetPrinter で取得できます。

Windows Vista 以降のバージョンの Windows では、次の値も使用できます。

意味
PRINTER_ATTRIBUTE_FRIENDLY_NAME コンピューターがこのプリンターに接続し、フレンドリ名を付けました。
PRINTER_ATTRIBUTE_MACHINE プリンターはコンピューター単位の接続です。
PRINTER_ATTRIBUTE_PUSHED_USER プリンターは、Push Printer Connections ユーザーポリシーを使用してインストールされました。
PRINTER_ATTRIBUTE_PUSHED_MACHINE プリンターは、Push Printer Connections コンピューターポリシーを使用してインストールされました。

DeviceNotSelectedTimeout

この値は使用されません。

TransmissionRetryTimeout

この値は使用されません。

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

各言語での定義

#include <windows.h>

// PRINTER_INFO_5A  (x64 32 / x86 20 バイト)
typedef struct PRINTER_INFO_5A {
    LPSTR pPrinterName;
    LPSTR pPortName;
    DWORD Attributes;
    DWORD DeviceNotSelectedTimeout;
    DWORD TransmissionRetryTimeout;
} PRINTER_INFO_5A;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct PRINTER_INFO_5A
{
    public IntPtr pPrinterName;
    public IntPtr pPortName;
    public uint Attributes;
    public uint DeviceNotSelectedTimeout;
    public uint TransmissionRetryTimeout;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure PRINTER_INFO_5A
    Public pPrinterName As IntPtr
    Public pPortName As IntPtr
    Public Attributes As UInteger
    Public DeviceNotSelectedTimeout As UInteger
    Public TransmissionRetryTimeout As UInteger
End Structure
import ctypes
from ctypes import wintypes

class PRINTER_INFO_5A(ctypes.Structure):
    _fields_ = [
        ("pPrinterName", ctypes.c_void_p),
        ("pPortName", ctypes.c_void_p),
        ("Attributes", wintypes.DWORD),
        ("DeviceNotSelectedTimeout", wintypes.DWORD),
        ("TransmissionRetryTimeout", wintypes.DWORD),
    ]
#[repr(C)]
pub struct PRINTER_INFO_5A {
    pub pPrinterName: *mut core::ffi::c_void,
    pub pPortName: *mut core::ffi::c_void,
    pub Attributes: u32,
    pub DeviceNotSelectedTimeout: u32,
    pub TransmissionRetryTimeout: u32,
}
import "golang.org/x/sys/windows"

type PRINTER_INFO_5A struct {
	pPrinterName uintptr
	pPortName uintptr
	Attributes uint32
	DeviceNotSelectedTimeout uint32
	TransmissionRetryTimeout uint32
}
type
  PRINTER_INFO_5A = record
    pPrinterName: Pointer;
    pPortName: Pointer;
    Attributes: DWORD;
    DeviceNotSelectedTimeout: DWORD;
    TransmissionRetryTimeout: DWORD;
  end;
const PRINTER_INFO_5A = extern struct {
    pPrinterName: ?*anyopaque,
    pPortName: ?*anyopaque,
    Attributes: u32,
    DeviceNotSelectedTimeout: u32,
    TransmissionRetryTimeout: u32,
};
type
  PRINTER_INFO_5A {.bycopy.} = object
    pPrinterName: pointer
    pPortName: pointer
    Attributes: uint32
    DeviceNotSelectedTimeout: uint32
    TransmissionRetryTimeout: uint32
struct PRINTER_INFO_5A
{
    void* pPrinterName;
    void* pPortName;
    uint Attributes;
    uint DeviceNotSelectedTimeout;
    uint TransmissionRetryTimeout;
}

HSP用 定義

HSP3.7/3.8 は構造体機能が無いため4byte整数配列(dim)+peek/poke で操作(32/64bitでサイズ・位置が異なる場合はタブで分割)。IronHSP は NSTRUCT(#defstruct/stdim/->)で32/64bit共通。

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; PRINTER_INFO_5A サイズ: 20 バイト(x86)
dim st, 5    ; 4byte整数×5(構造体サイズ 20 / 4 切り上げ)
; pPrinterName : LPSTR (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; pPortName : LPSTR (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; Attributes : DWORD (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; DeviceNotSelectedTimeout : DWORD (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; TransmissionRetryTimeout : DWORD (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; PRINTER_INFO_5A サイズ: 32 バイト(x64)
dim st, 8    ; 4byte整数×8(構造体サイズ 32 / 4 切り上げ)
; pPrinterName : LPSTR (+0, 8byte)  qpoke st,0,値 / qpeek(st,0)  ※IronHSPのみ。3.7/3.8は lpoke st,0,下位 : lpoke st,4,上位
; pPortName : LPSTR (+8, 8byte)  qpoke st,8,値 / qpeek(st,8)  ※IronHSPのみ。3.7/3.8は lpoke st,8,下位 : lpoke st,12,上位
; Attributes : DWORD (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; DeviceNotSelectedTimeout : DWORD (+20, 4byte)  st.5 = 値  /  値 = st.5   (lpoke/lpeek も可)
; TransmissionRetryTimeout : DWORD (+24, 4byte)  st.6 = 値  /  値 = st.6   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global PRINTER_INFO_5A
    #field intptr pPrinterName
    #field intptr pPortName
    #field int Attributes
    #field int DeviceNotSelectedTimeout
    #field int TransmissionRetryTimeout
#endstruct

stdim st, PRINTER_INFO_5A        ; NSTRUCT 変数を確保
st->Attributes = 100
mes "Attributes=" + st->Attributes