SetupDiRegisterCoDeviceInstallers 함수(setupapi.h)

  • 아티클

SetupDiRegisterCoDeviceInstallers 함수는 DIF_REGISTER_COINSTALLERS 대한 기본 처리기입니다.

구문

WINSETUPAPI BOOL SetupDiRegisterCoDeviceInstallers(
  [in] HDEVINFO         DeviceInfoSet,
  [in] PSP_DEVINFO_DATA DeviceInfoData
);

매개 변수

[in] DeviceInfoSet

공동 설치 관리자를 등록할 디바이스를 나타내는 디바이스 정보 요소가 포함된 디바이스 정보 집합 에 대한 핸들입니다. 디바이스 정보 집합에는 원격 요소가 포함되어서는 안됩니다.

[in] DeviceInfoData

DeviceInfoSet에서 디바이스 정보 요소를 지정하는 SP_DEVINFO_DATA 구조체에 대한 포인터입니다.

반환 값

SetupDiRegisterCoDeviceInstallers는 함수가 성공하면 TRUE 를 반환합니다. 함수가 FALSE를 반환하는 경우 확장된 오류 정보는 GetLastError 를 호출합니다.

설명

SetupDiRegisterCoDeviceInstallers의 호출자는 Administrators 그룹의 구성원이어야 합니다.

참고 클래스 설치 관리자만 SetupDiRegisterCoDeviceInstallers 를 호출해야 하며, SetupDiRegisterCoDeviceInstallers 가 기본 공동 설치 관리자 등록 작업을 완료한 후에는 클래스 설치 관리자가 공동 설치 관리자 등록 작업을 수행해야 하는 경우에만 호출해야 합니다. 이러한 경우 클래스 설치 관리자는 설치 관리자가 DIF_REGISTER_COINSTALLERS 요청을 처리할 때 SetupDiRegisterCoDeviceInstallers 를 직접 호출해야 합니다. 기본 처리기를 호출하는 방법에 대한 자세한 내용은 기본 DIF 코드 처리기 호출을 참조하세요.
 
SetupDiRegisterCoDeviceInstallers 는 DeviceInfoData 에 지정된 디바이스의 INF 파일을 읽고 레지스트리 항목을 만들어 INF 파일에 나열된 디바이스별 공동 설치 관리자를 등록합니다. 공동 설치 관리자는 INF DDInstall.CoInstallers 섹션에 나열됩니다. 이 함수는 DI_NOFILECOPY 플래그가 설정되지 않은 한 공동 설치 관리자에 대한 파일도 복사합니다.

선택한 드라이버가 없거나 장치에 Windows 9x 또는 Millennium Edition용 INF 파일이 있는 경우 이 함수는 공동 설치 관리자를 등록하지 않습니다.

새 디바이스별 공동 설치 관리자를 등록하면 디바이스 설치 관리자의 현재 공동 설치 관리자 목록이 무효화됩니다. 등록이 성공하면 디바이스 설치 관리자가 공동 설치 관리자 목록을 업데이트합니다.

이 함수는 클래스 공동 설치 관리자가 아닌 디바이스별 공동 설치 관리자만 등록합니다.

디바이스별 공동 설치 관리자를 작성하고 등록하는 방법에 대한 자세한 내용은 공동 설치 관리자 작성을 참조하세요.

DeviceInfoSet에서 지정한 디바이스 정보 집합에는 로컬 컴퓨터의 요소만 포함되어야 합니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Microsoft Windows 2000 이상 버전의 Windows에서 사용할 수 있습니다.
대상 플랫폼 데스크톱
머리글 setupapi.h(Setupapi.h 포함)
라이브러리 Setupapi.lib
DLL Setupapi.dll

추가 정보

DIF_REGISTER_COINSTALLERS

SetupDiCallClassInstaller