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 [デスクトップ アプリのみ] |
| ヘッダー |
|
| ライブラリ |
|
| [DLL] |
|
| Unicode 名と ANSI 名 |
AddPrintProvidorW (Unicode) と AddPrintProvidorA (ANSI) |