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 |