次の方法で共有

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 を返す必要があります。

要件

要件 値
対象プラットフォーム デスクトップ
Header winspool.h (Winspool.h を含む)