Share via

InstallPrinterDriverFromPackage 関数

  • [アーティクル]

プリント サーバーのドライバー ストアにあるドライバー パッケージからプリンター ドライバーをインストールします。

構文

HRESULT InstallPrinterDriverFromPackage(
  _In_ LPCTSTR pszServer,
  _In_ LPCTSTR pszInfPath,
  _In_ LPCTSTR pszDriverName,
  _In_ LPCTSTR pszEnvironment,
  _In_ DWORD   dwFlags
);

パラメーター

pszServer [in]

プリント サーバーの名前を指定する null で終わる定数文字列へのポインター。 NULL はローカル コンピューターを意味します。

pszInfPath [in]

印刷ドライバーの .inf ファイルへのドライバー ストア パスを指定する、null で終わる定数文字列へのポインター。 NULL は、ドライバーが Windows に付属する inf ファイルにあることを意味します。

pszDriverName [in]

ドライバーの名前を指定する null で終わる定数文字列へのポインター。

pszEnvironment [in]

プロセッサ アーキテクチャを指定する定数 null で終わる文字列へのポインター (たとえば、x86 Windows NT)。 NULL を指定できます。

dwFlags [in]

これは、0 またはIPDFP_COPY_ALL_FILESに限定できます。 値 0 は、プリンター ドライバーを追加する必要があり、現在使用されている対応するファイルよりも新しいプリンター ドライバー ディレクトリ内のすべてのファイルをコピーする必要があることを意味します。 IPDFP_COPY_ALL_FILESの値は、プリンター ドライバーとプリンター ドライバー ディレクトリ内のすべてのファイルを追加する必要があります。 dwFlags の値が IPDFP_COPY_ALL_FILES の場合、ファイルのタイム スタンプは無視されます。

戻り値

操作が成功した場合、戻り値はS_OK。それ以外の場合、 HRESULT にはエラー コードが含まれます。

COM エラー コードの詳細については、「エラー 処理」を参照してください。

注釈

注意

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

ドライバー ストアは通常、%windir%\inf または %windir%\System32\DriverStore\FileRepository です。

InstallPrinterDriverFromPackage は 、カラー プロファイルや印刷プロセッサなど、パッケージ内の他のファイルもインストールします。

ユーザーがターミナル サービスでログインしている場合、リモート コンピューターまたはローカル コンピューターにインストールするには、プリンター管理権限が必要です。

署名済みパッケージのみをリモート コンピューターにインストールできます。

要件

要件 値
サポートされている最小のクライアント
 Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー
 Windows Server 2008 [デスクトップ アプリのみ]
Header
Winspool.h (Windows.h を含む)
ライブラリ
Winspool.lib
[DLL]
Spoolss.dll
Unicode 名と ANSI 名
 InstallPrinterDriverFromPackageW (Unicode) と InstallPrinterDriverFromPackageA (ANSI)

関連項目

印刷

印刷スプーラー API 関数