AddPrintProvidor 関数

重要

2021 年 7 月 6 日、 KB5005010 では、この API へのアクセスを管理者ユーザーのみに制限するオプションのレジストリ ベースの構成オプションが導入されました。 このオプションは既定ではオフでした。

2021 年 8 月 10 日、 KB5005652 は、新しいプリンター ドライバーをインストールするための管理者権限を必要とするように、この構成の既定値を変更します。

AddPrintProvidor 関数は、ローカル印刷プロバイダーをインストールし、構成、データ、およびプロバイダー ファイルをリンクします。

構文

BOOL AddPrintProvidor(
  _In_ LPTSTR pName,
  _In_ DWORD  Level,
  _In_ LPBYTE pProviderInfo
);

パラメーター

pName [in]

プロバイダーをインストールするサーバーの名前を指定する null で終わる文字列へのポインター。 プロバイダーのローカル インストールのみをサポートするシステムの場合、このパラメーターは NULL にする必要があります。

レベル [入力]

pProviderInfo が指す構造体のレベル。 次のいずれかになります。

値	説明
1	関数は 、PROVIDOR_INFO_1 構造体を使用します。
2	関数は 、PROVIDOR_INFO_2 構造体を使用します。

pProviderInfo [in]

Level で示される印刷プロバイダー構造へのポインター。

戻り値

関数が成功した場合、戻り値は 0 以外の値になります。

関数が失敗した場合は、0 を返します。

注釈

注意

これはブロック関数または同期関数であり、すぐには返されない可能性があります。 この関数が返す速度は、ネットワーク状態、プリント サーバーの構成、プリンター ドライバーの実装要因など、アプリケーションの作成時に予測が困難な実行時の要因によって異なります。 ユーザー インターフェイスとの対話を管理するスレッドからこの関数を呼び出すと、アプリケーションが応答しなくなる可能性があります。

アプリケーションが AddPrintProvidor 関数を呼び出す前に、プロバイダーに必要なすべてのファイルを SYSTEM32 ディレクトリにコピーする必要があります。

AddPrintProvidor によって追加されたプロバイダーは、DeletePrintProvidor を呼び出すことによって削除できます。

要件

要件	値
サポートされている最小のクライアント	Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップ アプリのみ]
ヘッダー	Winspool.h (Windows.h を含む)
ライブラリ	Winspool.lib
[DLL]	Winspool.drv
Unicode 名と ANSI 名	AddPrintProvidorW (Unicode) と AddPrintProvidorA (ANSI)

関連項目

印刷

印刷スプーラー API 関数

DeletePrintProvidor

PROVIDOR_INFO_1

PROVIDOR_INFO_2