EnumPrintProcessorDatatypesA 関数 (winspool.h)
印刷プロセッサの EnumPrintProcessorDatatypes 関数は、印刷プロセッサがサポートするデータ型を列挙します。
構文
BOOL EnumPrintProcessorDatatypesA(
[in, optional] LPSTR pName,
[in] LPSTR pPrintProcessorName,
DWORD Level,
[out, optional] LPBYTE pDatatypes,
DWORD cbBuf,
[out] LPDWORD pcbNeeded,
[out] LPDWORD pcReturned
);
パラメーター
[in, optional] pName
印刷プロセッサがインストールされているサーバーの名前を表す文字列への呼び出し元指定のポインター。 NULL 場合、サーバーはローカル システムです。
[in] pPrintProcessorName
印刷プロセッサ名を表す文字列への呼び出し元指定のポインター。
Level
pDatatypes が指すバッファー内で返される構造体の型を示す呼び出し元指定の値。 この値は、構造体がDATATYPES_INFO_1されていることを示す 1 である必要があります。
[out, optional] pDatatypes
DATATYPES_INFO_1構造体の配列を受け取り、その後にデータ型名を表す文字列のセットを受け取るバッファーへの呼び出し元指定のポインター。 DATATYPES_INFO_1構造については、Microsoft Windows SDK のドキュメントを参照してください。 pName 構造体メンバーは LPWSTR 型である必要があります。
cbBuf
pDatatypes が指すバッファーのサイズ (バイト単位) を表す呼び出し元指定の値。
[out] pcbNeeded
pDatatypes が指すバッファーに必要な最小サイズを受け取る場所呼び出し元が指定したポインター。
[out] pcReturned
pDatatypes が指すバッファーで返されるDATATYPES_INFO_1構造体の数を受け取る場所呼び出し元が指定したポインター。
戻り値
操作が成功した場合、関数は TRUE 返す必要があります。 操作が失敗した場合、関数は SetLastError 呼び出してエラー コードを設定し、FALSE 返す必要があります。
備考
EnumPrintProcessorDatatypes 関数をエクスポートするには、印刷プロセッサが必要です。 ローカル印刷プロバイダーは、初期化中に関数を呼び出します。 この関数は、アプリケーションが同じ関数のスプーラーのバージョンを呼び出すときにも呼び出されます。
この関数は、各構造体がデータ型を表す文字列を指すDATATYPES_INFO_1構造体の配列を返す必要があります。 構造体配列の後に、実際の文字列もバッファーに含まれている必要があります。 例については、「サンプル印刷プロセッサの」を参照してください。
この関数は、pcReturned が指す場所で返されるDATATYPES_INFO_1構造体の数 (つまり、サポートされているデータ型の数)返す必要があります。
この関数は、pcbNeededが指す位置に必要な最小バッファー サイズを返す必要があります。 指定されたバッファーが小さすぎる場合、関数は pcbNeeded 値を指定し、エラー コードをERROR_INSUFFICIENT_BUFFERに設定し、FALSE 返す必要があります。
必要条件
要件 | 価値 |
---|---|
ターゲット プラットフォーム の | デスクトップ |
ヘッダー | winspool.h (Winspool.h を含む) |