|
パラメータ
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 |
|