ReadPrinter 関数
ReadPrinter 関数は、指定したプリンターからデータを取得します。
構文
BOOL ReadPrinter(
_In_ HANDLE hPrinter,
_Out_ LPVOID pBuf,
_In_ DWORD cbBuf,
_Out_ LPDWORD pNoBytesRead
);
パラメーター
-
hPrinter [in]
-
データを取得するプリンター オブジェクトのハンドル。 プリンター オブジェクト ハンドルを取得するには、 OpenPrinter 関数を使用します。 Printername、Job xxxx の形式を使用します。
-
pBuf [out]
-
プリンター データを受け取るバッファーへのポインター。
-
cbBuf [in]
-
pBuf が指すバッファーのサイズ (バイト単位)。
-
pNoBytesRead [out]
-
pBuf が指す配列にコピーされたデータのバイト数を受け取る変数へのポインター。
戻り値
関数が成功した場合、戻り値は 0 以外の値になります。
関数が失敗した場合は、0 を返します。
解説
Note
これはブロック関数または同期関数であり、すぐには返されない可能性があります。 この関数が返す速度は、ネットワーク状態、プリント サーバーの構成、プリンター ドライバーの実装要因など、アプリケーションの作成時に予測が困難な実行時の要因によって異なります。 ユーザー インターフェイスとの対話を管理するスレッドからこの関数を呼び出すと、アプリケーションが応答しなくなる可能性があります。
デバイスまたはプリンターが双方向でない場合、ReadPrinter はエラーを返します。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント |
Windows 2000 Professional [デスクトップ アプリのみ] |
サポートされている最小のサーバー |
Windows 2000 Server [デスクトップ アプリのみ] |
ヘッダー |
|
ライブラリ |
|
[DLL] |
|