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 |
|
| ライブラリ |
|
| [DLL] |
|
| Unicode 名と ANSI 名 |
InstallPrinterDriverFromPackageW (Unicode) と InstallPrinterDriverFromPackageA (ANSI) |