CM_WaitNoPendingInstallEvents 함수(cfgmgr32.h)
CMP_WaitNoPendingInstallEvents(CM_WaitNoPendingInstallEvents) 함수는 PnP 관리자가 수행할 보류 중인 디바이스 설치 작업이 없을 때까지 기다립니다.
구문
DWORD CM_WaitNoPendingInstallEvents(
[in] DWORD dwTimeout
);
매개 변수
[in] dwTimeout
시간 제한 간격(밀리초)을 지정합니다.
- dwTimeout이 0으로 설정된 경우 함수는 보류 중인 설치 이벤트가 있는지 테스트하고 즉시 반환합니다.
- dwTimeout이 INFINITE(Winbase.h에 정의됨)로 설정된 경우 함수의 제한 시간 간격이 경과하지 않습니다.
- 다른 모든 dwTimeout 값의 경우 함수는 아직 보류 중인 설치 이벤트가 있더라도 지정된 간격이 경과하면 를 반환합니다.
반환 값
함수는 다음 값 중 하나를 반환합니다( Winbase.h에 정의됨).
| 반환 코드 | 설명 |
|---|---|
|
보류 중인 설치 작업이 없습니다. |
|
시간 제한 간격이 경과하고 설치 작업이 아직 보류 중입니다. |
|
함수가 실패했습니다. 추가 오류 정보는 GetLastError 를 호출합니다. |
설명
함수는 PnP 관리자가 보류 중인 설치 작업이 없다고 판단할 때 설정하는 내부 이벤트 개체를 기다립니다.
0이 아닌 시간 제한 값이 지정된 경우 CMP_WaitNoPendingInstallEvents 설치 이벤트가 보류 중이 아니거나 시간 제한 기간이 만료된 경우 중 하나를 먼저 반환합니다.
새 설치 이벤트는 언제든지 발생할 수 있습니다. 이 함수는 호출되는 시점에 보류 중인 설치 작업이 없음을 나타냅니다.
이 함수는 일반적으로 디바이스 설치 애플리케이션에서 사용됩니다. 자세한 내용은 디바이스 설치 애플리케이션 작성을 참조하세요.
짧은 시간 내에 반환될 것으로 예상되는 시스템 시작 콜백 함수 내에서 이벤트를 처리하는 동안 이 함수를 호출하지 마세요. 여기에는 서비스 시작(예 : ServiceMain 콜백 함수) 또는 서비스 처리기(예: 처리기 콜백 함수) 또는 클래스 설치 관리자 또는 공동 설치 관리자와 같은 설치 구성 요소에서 모든 컨트롤을 처리하는 동안의 서비스 시작이 포함됩니다.
Windows XP(서비스 팩이 설치되지 않음)의 경우 이 함수는 관리자 권한으로 세션 0에서 호출되어야 합니다. WINDOWS XP SP1(서비스 팩 1) 이상 버전의 Windows의 경우 모든 세션에서 함수를 호출할 수 있으며 관리자 권한은 필요하지 않습니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows XP 이상 버전의 Windows에서 사용할 수 있습니다. |
| 대상 플랫폼 | 데스크톱 |
| 머리글 | cfgmgr32.h(Cfgmgr32.h 포함) |
| 라이브러리 | Cfgmgr32.lib |
| DLL | Cfgmgr32.dll |