다음을 통해 공유

DeletePrinterDriver 함수

  • 아티클

DeletePrinterDriver 함수는 서버에서 지원되는 드라이버 이름 목록에서 지정된 프린터 드라이버 이름을 제거합니다.

서버에 대해 지원되는 드라이버 이름 목록에서 지정된 프린터 드라이버 이름을 제거하는 것 외에도 드라이버와 연결된 파일을 삭제하려면 DeletePrinterDriverEx 함수를 사용합니다.

DeletePrinterDriver 는 지정된 환경에 사용 중인 드라이버 버전이 없는 경우에만 드라이버를 삭제합니다. DeletePrinterDriverEx 는 특정 버전의 드라이버를 삭제할 수 있습니다.

구문

BOOL DeletePrinterDriver(
  _In_ LPTSTR pName,
  _In_ LPTSTR pEnvironment,
  _In_ LPTSTR pDriverName
);

매개 변수

pName [in]

드라이버를 삭제할 서버의 이름을 지정하는 null로 끝나는 문자열에 대한 포인터입니다. 이 매개 변수가 NULL이면 프린터 드라이버 이름이 로컬로 제거됩니다.

pEnvironment [in]

드라이버를 삭제할 환경을 지정하는 null로 끝나는 문자열에 대한 포인터입니다(예: Windows x86, Windows IA64 또는 Windows x64). 이 매개 변수가 NULL인 경우 드라이버 이름은 대상 애플리케이션 및 인쇄 서버가 아닌 호출 애플리케이션 및 클라이언트 컴퓨터의 현재 환경에서 삭제됩니다.

pDriverName [in]

삭제해야 하는 드라이버의 이름을 지정하는 null로 끝나는 문자열에 대한 포인터입니다.

반환 값

함수가 성공하면 반환 값은 0이 아닌 값입니다.

함수가 실패하면 반환 값은 0입니다.

설명

참고

이는 차단 또는 동기 함수이며 즉시 반환되지 않을 수 있습니다. 이 함수가 얼마나 빨리 반환되는지는 네트워크 상태, 인쇄 서버 구성 및 애플리케이션을 작성할 때 예측하기 어려운 프린터 드라이버 구현 요소와 같은 런타임 요인에 따라 달라집니다. 사용자 인터페이스와의 상호 작용을 관리하는 스레드에서 이 함수를 호출하면 애플리케이션이 응답하지 않는 것처럼 보일 수 있습니다.

호출자에게 는 SeLoadDriverPrivilege가 있어야 합니다.

DeletePrinterDriver 함수는 연결된 파일을 삭제하지 않고 EnumPrinterDrivers 함수에서 반환된 목록에서 드라이버 이름을 제거합니다.

DeletePrinterDriver를 호출하기 전에 프린터 드라이버를 사용하는 모든 프린터 개체를 삭제해야 합니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트
 Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버
 Windows 2000 Server[데스크톱 앱만]
헤더
Winspool.h(Windows.h 포함)
라이브러리
Winspool.lib
DLL
Winspool.drv
유니코드 및 ANSI 이름
 DeletePrinterDriverW (유니코드) 및 DeletePrinterDriverA (ANSI)

추가 정보

인쇄

인쇄 스풀러 API 함수

DeletePrinterDriverEx

EnumPrinterDrivers