<Return[S]><Top>

SetPrinterData

Declare Function Api_SetPrinterData& Lib "winspool.drv" Alias "SetPrinterDataA" (ByVal hPrinter&, ByVal pValueName$, ByVal dwType&, pData As Byte, ByVal cbData&)

Declare Function SetPrinterData Lib "winspool.drv" Alias "SetPrinterDataA" (ByVal hPrinter As Long, ByVal pValueName As String, ByVal dwType As Long, pData As Byte, ByVal cbData As Long) As Long

プリンタまたはプリントサーバーの構成データを設定する。
Windows NT 5.0 以降 : パラメータ pKeyName を "PrinterDriverData" に設定した SetPrinterDataEx 関数と同じ働きをする。

パラメータ
hPrinter
    構成データを設定するプリンタまたはプリントサーバーを識別するハンドルを指定する。このハンドルは、OpenPrinter 関数を使って取得す

    る。
pValueName
    設定するデータを識別する NULL で終わる文字列へのポインタを指定する。
    プリンタの場合、この文字列はレジストリ内のそのプリンタに関する "PrinterDriverData" キーの下にあるレジストリ値の名前である。
    プリントサーバーの場合、この文字列は解説に示す定義済み文字列の 1 つである。
Type
    値のデータとして格納する情報の型を指定する。次のいずれかの値を指定する。

    値                                                   

意味                                                                                                                     

    REG_BINARY

任意の形式のバイナリデータ。

    REG_DWORD

32 ビット数。

    REG_DWORD_LITTLE_ENDIAN

 

 

 

 

 

リトルエンディアン形式の 32 ビット数。REG_DWORD と同等である。
リトルエンディアン形式では、マルチバイト値がメモリに格納されるとき、最下位のバイト("リトルエンド")から順に格納され、最上位バイトが最後に格納される。たとえば 0x12345678 は、リトルエンディアン形式では(0x78 0x56 0x34 0x12)として格納される。
Windows NT と Windows 95 は、リトルエンディアンコンピュータアーキテクチャ上で稼働するように設計されている。ユーザーは、ビッグエンディアンアーキテクチャを持つコンピュータ(一部の UNIX システムなど)に接続することができる。

    REG_EXPAND_SZ

 

 

環境変数への展開されていない参照("%PATH%" など)が含まれている NULL で終わる文字列。Unicode 関数を使った場合は Unicode 文字列、ANSI 関数を使った場合は ANSI 文字列になる。

    REG_LINK

Unicode シンボリックリンク。

    REG_MULTI_SZ

NULL で終わる文字列の配列。配列は 2 つの NULL で終わる。

    REG_NONE

格納する値の型が定義されていない場合に指定する。

    REG_RESOURCE_LIST

デバイスドライバのリソースリスト。

    REG_SZ

 

NULL で終わる文字列。Unicode 関数を使った場合は Unicode 文字列、ANSI 関数を使った場合は ANSI 文字列になる。

pData
    プリンタ構成データを保持するバイト配列へのポインタを指定する。
cbData
    配列のサイズをバイト単位で指定する。

戻り値
    関数が成功すると、ERROR_SUCCESS が返る。
    関数が失敗すると、エラー値が返る。

解説
    プリンタの既存の構成データを取得するには、GetPrinterDataEx 関数または GetPrinterData 関数を使う。
    hPrinter がプリントサーバーを識別するハンドルの場合は、pValueName に次のいずれかの定義済み値を指定する。

    SPLREG_DEFAULT_SPOOL_DIRECTORY

DefaultSpoolDirectory

    SPLREG_PORT_THREAD_PRIORITY_DEFAULT

PortThreadPriorityDefault

    SPLREG_PORT_THREAD_PRIORITY

PortThreadPriority

    SPLREG_SCHEDULER_THREAD_PRIORITY_DEFAULT

SchedulerThreadPriorityDefault

    SPLREG_SCHEDULER_THREAD_PRIORITY

SchedulerThreadPriority

    SPLREG_BEEP_ENABLED

BeepEnabled

    SPLREG_NET_POPUP

NetPopup

    SPLREG_EVENT_LOG

EventLog

    SPLREG_MAJOR_VERSION

MajorVersion

    SPLREG_MINOR_VERSION

MinorVersion

    SPLREG_ARCHITECTURE

Architecture

    SPLREG_OS_VERSION

OsVersion