CM_Setup_DevNode 함수(cfgmgr32.h)

아티클
08/22/2023

CM_Setup_DevNode 함수는 디바이스 구성에 문제가 있으므로 실행되지 않는 디바이스 instance 다시 시작합니다.

구문

CMAPI CONFIGRET CM_Setup_DevNode(
  [in] DEVINST dnDevInst,
  [in] ULONG   ulFlags
);

매개 변수

[in] dnDevInst

로컬 시스템에 바인딩된 디바이스 instance 핸들입니다.

[in] ulFlags

다음 플래그 값 중 하나입니다.

CM_SETUP_DEVNODE_READY

디바이스 구성 문제로 인해 실행되지 않는 디바이스 instance 다시 시작합니다.

CM_SETUP_DEVNODE_RESET(Windows XP 이상 버전의 Windows)

다시 시작 디바이스 상태 플래그가 설정되지 않은 디바이스 instance 다시 설정합니다. CM_Query_And_Remove_SubTree 또는 CM_Query_And_Remove_SubTree_Ex 호출하고 CM_REMOVE_NO_RESTART 플래그를 지정하여 디바이스가 제거되면 다시 시작 디바이스 상태 플래그가 설정되지 않습니다.

반환 값

작업이 성공하면 함수는 CR_SUCCESS 반환합니다. 그렇지 않으면 Cfgmgr32.h에 정의된 "CR_" 접두사를 사용하여 오류 코드 중 하나를 반환합니다.

설명

디바이스 설치 애플리케이션은 이 함수를 사용하는 대신 DIF_PROPERTYCHANGE 요청을 사용하여 디바이스를 다시 시작해야 합니다. DIF_PROPERTYCHANGE 요청을 사용하여 디바이스의 속성을 활성화, 비활성화, 다시 시작, 중지 또는 변경할 수 있습니다.

디바이스 instance 문제가 없고 이미 시작된 경우 CM_Setup_DevNode 디바이스 instance 상태 변경하지 않고 반환됩니다.

CM_Get_DevNode_Status 또는 CM_Get_DevNode_Status_Ex 호출하여 디바이스 instance 대한 상태 및 문제 코드를 확인합니다.

요구 사항


지원되는 최소 클라이언트	Microsoft Windows 2000 이상 버전의 Windows에서 사용할 수 있습니다.
대상 플랫폼	유니버설
헤더	cfgmgr32.h(Cfgmgr32.h 포함)
라이브러리	Cfgmgr32.lib; Windows 10 OneCoreUAP.lib
DLL	CfgMgr32.dll