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에 정의됨).

반환 코드	설명
WAIT_OBJECT_0	보류 중인 설치 작업이 없습니다.
WAIT_TIMEOUT	시간 제한 간격이 경과하고 설치 작업이 아직 보류 중입니다.
WAIT_FAILED	함수가 실패했습니다. 추가 오류 정보는 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

추가 정보

CM_WaitNoPendingInstallEvents

디바이스 설치 애플리케이션이 진행 중인 디바이스 설치를 확인하는 방법