DeletePrinterDriver 関数
DeletePrinterDriver 関数は、サーバー上でサポートされているドライバーの名前の一覧から、指定されたプリンター ドライバー名を削除します。
サーバーでサポートされているドライバーの名前の一覧から指定されたプリンター ドライバー名を削除するだけでなく、ドライバーに関連付けられているファイルを削除するには、 DeletePrinterDriverEx 関数を使用します。
DeletePrinterDriver は、ドライバーのバージョンが指定された環境で使用されていない場合にのみ、ドライバーを削除します。 DeletePrinterDriverEx は、ドライバーの特定のバージョンを削除できます。
構文
BOOL DeletePrinterDriver(
_In_ LPTSTR pName,
_In_ LPTSTR pEnvironment,
_In_ LPTSTR pDriverName
);
パラメーター
-
pName [in]
-
ドライバーを削除するサーバーの名前を指定する null で終わる文字列へのポインター。 このパラメーターが NULL の場合、プリンター ドライバー名はローカルに削除されます。
-
pEnvironment [in]
-
ドライバーの削除元の環境 (Windows x86、Windows IA64、Windows x64 など) を指定する null で終わる文字列へのポインター。 このパラメーターが NULL の場合、ドライバー名は呼び出し元のアプリケーションとクライアント コンピューターの現在の環境から削除されます (移行先アプリケーションとプリント サーバーではありません)。
-
pDriverName [in]
-
削除するドライバーの名前を指定する null で終わる文字列へのポインター。
戻り値
関数が成功した場合、戻り値は 0 以外の値になります。
関数が失敗した場合は、0 を返します。
注釈
注意
これはブロック関数または同期関数であり、すぐには返されない可能性があります。 この関数が返す速度は、ネットワーク状態、プリント サーバーの構成、プリンター ドライバーの実装要因など、アプリケーションの作成時に予測が困難な実行時の要因によって異なります。 ユーザー インターフェイスとの対話を管理するスレッドからこの関数を呼び出すと、アプリケーションが応答しなくなる可能性があります。
呼び出し元には SeLoadDriverPrivilege が必要です。
DeletePrinterDriver 関数は、関連付けられているファイルを削除せず、EnumPrinterDrivers 関数によって返される一覧からドライバー名を削除するだけです。
DeletePrinterDriver を呼び出す前に、プリンター ドライバーを使用するすべてのプリンター オブジェクトを削除する必要があります。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント |
Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー |
Windows 2000 Server [デスクトップ アプリのみ] |
| ヘッダー |
|
| ライブラリ |
|
| [DLL] |
|
| Unicode 名と ANSI 名 |
DeletePrinterDriverW (Unicode) と DeletePrinterDriverA (ANSI) |