UnRegisterForPrintAsyncNotifications 함수(prnasnot.h)
등록한 애플리케이션이 인쇄 스풀러 호스팅 인쇄 구성 요소에서 등록 취소에 대한 알림을 받을 수 있도록 합니다.
구문
HRESULT UnRegisterForPrintAsyncNotifications(
[in] HANDLE unnamedParam1
);
매개 변수
[in] unnamedParam1
등록 취소할 등록 핸들입니다.
반환 값
| HRESULT | 심각도 | 의미 |
|---|---|---|
| S_OK | SUCCESS | 함수가 성공적으로 완료되었습니다. |
| ALREADY_UNREGISTERED |
SUCCESS 오류 |
등록 처리기가 이미 등록 취소되었습니다. 이 HRESULT에 오류 심각도가 있는 경우 호출 함수는 오류 조건을 처리해야 합니다. |
| NOT_REGISTERED | SUCCESS | 등록 처리기가 등록되지 않았습니다. |
반환 값은 COM 오류 코드입니다. 이 함수는 작업을 성공적으로 완료할 수 있지만 S_OK 이외의 HRESULT 를 반환할 수 있으므로 SUCCEEDED 또는 FAILED 매크로를 사용하여 호출의 성공을 결정해야 합니다. 함수에서 반환된 특정 HRESULT 를 얻으려면 HRESULT_CODE 매크로를 사용합니다.
다음 코드 예제에서는 이러한 매크로를 사용하여 반환 값을 평가하는 방법을 보여 줍니다.
if (SUCCEEDED(hr)) {
// Call succeeded, check HRESULT value returned
switch (HRESULT_CODE(hr)){
case S_OK:
// Some action
break;
case NOT_REGISTERED:
// Some action
break;
case ALREADY_UNREGISTERED:
// Some action
break;
default:
// Default action
break;
}
} else {
// Call failed, check HRESULT value returned
switch (HRESULT_CODE(hr)){
// This can be error and a successful return
case ALREADY_UNREGISTERED:
// Some action
break;
default:
// Default action
break;
}
}
COM 오류 코드에 관한 자세한 내용은 오류 처리를 참조하세요.
가능한 다른 반환 값 은 PrintAsyncNotifyError 를 참조하세요.
설명
참고 이는 차단 또는 동기 함수이며 즉시 반환되지 않을 수 있습니다. 이 함수가 얼마나 빨리 반환되는지는 네트워크 상태, 인쇄 서버 구성 및 프린터 드라이버 구현과 같은 런타임 요인(애플리케이션을 작성할 때 예측하기 어려운 요소)에 따라 달라집니다. 사용자 인터페이스와의 상호 작용을 관리하는 스레드에서 이 함수를 호출하면 애플리케이션이 응답하지 않는 것처럼 보일 수 있습니다.
채널이 양방향인 경우 UnRegisterForPrintAsyncNotifications 를 호출하면 해당 시점 이후에 생성된 통신 채널의 알림만 차단됩니다. 기존 채널에서 알림을 종료하려면 수신 대기 애플리케이션이 IPrintAsyncNotifyChannel::CloseChannel을 사용하여 채널을 닫아야 합니다.
UnRegisterForPrintAsyncNotifications를 호출하면 RegisterForPrintAsyncNotifications에 전달된 pCallback 개체의 참조 수가 감소합니다.
이 함수가 성공하면 hRegistrationHandler 가 잘못되었으며 다시 사용하면 안 됩니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows Vista [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2008 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | prnasnot.h |
| 라이브러리 | WinSpool.lib |
| DLL | Spoolss.dll |