SetupDiGetDeviceInfoListDetailW 함수(setupapi.h)

SetupDiGetDeviceInfoListDetail 함수는 클래스 GUID, 원격 컴퓨터 핸들 및 원격 컴퓨터 이름을 포함하여 디바이스 정보 집합과 관련된 정보를 검색합니다.

통사론

WINSETUPAPI BOOL SetupDiGetDeviceInfoListDetailW(
  [in]  HDEVINFO                       DeviceInfoSet,
  [out] PSP_DEVINFO_LIST_DETAIL_DATA_W DeviceInfoSetDetailData
);

매개 변수

[in] DeviceInfoSet

정보를 검색할 디바이스 정보 집합에 대한 핸들입니다.

[out] DeviceInfoSetDetailData

디바이스 정보 집합 정보를 수신하는 호출자 초기화된 SP_DEVINFO_LIST_DETAIL_DATA 구조체에 대한 포인터입니다. 이 구조에 대한 자세한 내용은 다음 설명 섹션을 참조하세요.

반환 값

함수는 성공하면 TRUE 반환합니다. 그렇지 않으면 FALSE 반환하고 GetLastError호출하여 기록된 오류를 검색할 수 있습니다.

발언

매개 변수가 유효한 경우 SetupDiGetDeviceInfoListDetail DeviceInfoSetDetailData 구조(cbSize 필드 제외)의 값을 설정하고 상태 NO_ERROR 반환합니다.

SetupDiGetDeviceInfoListDetail 호출자는 DeviceInfoSetDetailData를 설정해야 합니다. cbSize sizeof(SP_DEVINFO_LIST_DETAIL_DATA)로함수가 실패하고 GetLastError 호출하면 ERROR_INVALID_USER_BUFFER 반환됩니다.

SetupDiGetDeviceInfoListDetail 성공적으로 완료되면 DeviceInfoSetDetailData를 .ClassGuid 디바이스 정보 집합 또는 GUID_NULL 구조와 연결된 클래스 GUID를 포함합니다.

SetupDiGetDeviceInfoListDetail 성공적으로 완료되고 디바이스 정보 집합이 원격 시스템에 대한 경우 DeviceInfoSetDetailData를 .RemoteMachineHandle 원격 시스템에 액세스하고 DeviceInfoSetDetailData를 ConfigMgr32 시스템 핸들을 포함합니다.RemoteMachineName 원격 시스템의 이름을 포함합니다. 디바이스 정보 집합에 대한 원격 핸들이 있는 경우 DevInst 핸들이 원격 핸들을 기준으로 하기 때문에 CM_Xxx_Ex 함수를 호출할 때 사용해야 합니다.

로컬 컴퓨터에 대한 디바이스 정보 집합인 경우 DeviceInfoSetDetailData를 .RemoteMachineHandle NULL DeviceInfoSetDetailData를 .RemoteMachineName 빈 문자열입니다.

메모

setupapi.h 헤더는 SETUPDiGetDeviceInfoListDetail을 유니코드 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입대한 규칙을 참조하세요.

요구 사항

요구	값
지원되는 최소 클라이언트	Microsoft Windows 2000 이상 버전의 Windows에서 사용할 수 있습니다.
대상 플랫폼	바탕 화면
헤더	setupapi.h(Setupapi.h 포함)
라이브러리	Setupapi.lib

참고 항목

SetupDiCreateDeviceInfoListEx

SetupDiGetClassDevsEx

setupDiGetDeviceInfoListClass