EngGetPrinter 関数 (winddi.h)

  • [アーティクル]

EngGetPrinter 関数は、指定したプリンターに関する情報を取得します。

構文

ENGAPI BOOL EngGetPrinter(
  [in]            HANDLE  hPrinter,
  [in]            DWORD   dwLevel,
  [out, optional] LPBYTE  pPrinter,
  [in]            DWORD   cbBuf,
  [out]           LPDWORD pcbNeeded
);

パラメーター

[in] hPrinter

データを取得するプリンターを処理します。 これは、DrvEnablePDEV の hDriver パラメーターとして渡されるハンドルです。

[in] dwLevel

pPrinter が指す構造体のバージョンを指定します。 このパラメーターには次の値を指定できます。

値 pPrinter 経由で返される構造体
1 PRINTER_INFO_1
2 PRINTER_INFO_2
3 PRINTER_INFO_3
4 PRINTER_INFO_4
5 PRINTER_INFO_5

[out, optional] pPrinter

dwLevel で識別されるプリンター情報構造体が読み込まれるメモリ バッファーへのポインター。

[in] cbBuf

pPrinter が指すメモリ バッファーのサイズをバイト単位で指定します。

[out] pcbNeeded

関数が成功した場合にコピーされたバイト数を受け取るメモリ位置へのポインター。 cbBuf が小さすぎる場合は必要なバイト数。

戻り値

EngGetPrinter は 成功すると TRUE を 返します。それ以外の場合は、エラーをログに記録し、 FALSE を返します。 エラー情報を取得するには、 EngGetLastError を呼び出します。

解説

PRINTER_INFO_X 構造体は、Microsoft Windows SDKドキュメントで定義されています。

要件

   
サポートされている最小のクライアント Windows 2000 以降のバージョンの Windows オペレーティング システムで使用できます。
対象プラットフォーム ユニバーサル
Header winddi.h (Winddi.h を含む)
Library Win32k.lib
[DLL] Win32k.sys

関連項目

DrvEnablePDEV