CM_Get_Child 함수(cfgmgr32.h)

CM_Get_Child 함수는 로컬 컴퓨터의 디바이스 트리에서 지정된 디바이스 노드(devnode)의 첫 번째 자식 노드에 대한 디바이스 instance 핸들을 검색하는 데 사용됩니다.

참고

Windows Vista 이상 버전의 Windows에서 통합 디바이스 속성 모델은 DEVPKEY_Device_Children속성 키를 사용하여 디바이스 자식을 나타냅니다. 자세한 내용은 디바이스 관계 검색을 참조하세요.

구문

CMAPI CONFIGRET CM_Get_Child(
  [out] PDEVINST pdnDevInst,
  [in]  DEVINST  dnDevInst,
  [in]  ULONG    ulFlags
);

[out] pdnDevInst

디바이스에 대한 호출자 제공 포인터는 이 함수가 검색하는 자식 노드에 대한 핸들을 instance. 검색된 핸들은 로컬 컴퓨터에 바인딩됩니다. 설명 섹션 을 참조하세요.

[in] dnDevInst

호출자가 제공한 디바이스는 로컬 컴퓨터에 바인딩된 핸들을 instance.

[in] ulFlags

사용되지 않음, 0이어야 합니다.

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

로컬 머신의 디바이스 트리에서 devnode의 모든 자식을 열거하려면 먼저 CM_Get_Child 호출하여 첫 번째 자식 노드에 대한 디바이스 instance 핸들을 가져온 다음, CM_Get_Sibling 호출하여 나머지 자식에 대한 핸들을 가져옵니다.

디바이스 인스턴스 핸들 사용

PnP 구성 관리자 함수와 함께 사용하는 디바이스 instance 핸들은 다음과 같이 컴퓨터 핸들에 바인딩됩니다.

모든 로컬 디바이스 instance 핸들은 NULL 반환 로컬 컴퓨터 핸들에 바인딩됩니다.
원격 컴퓨터 핸들을 사용하여 디바이스 instance 핸들을 가져오는 경우 결과 원격 디바이스 instance 핸들이 원격 컴퓨터 핸들에 바인딩됩니다.
디바이스 instance 핸들은 바인딩된 컴퓨터 핸들에서만 사용할 수 있습니다.
디바이스 instance 핸들은 두 디바이스 instance 핸들이 동일한 컴퓨터 핸들에 바인딩된 경우에만 다른 디바이스 instance 핸들과 함께 사용할 수 있습니다.

로컬 컴퓨터에 바인딩된 디바이스 instance 핸들을 가져오려면 다음 중 하나를 수행합니다.

CM_Locate_DevNode, CM_Get_Child, CM_Get_Parent 또는 CM_Get_Sibling 로컬 디바이스 instance 핸들만 검색하는 함수 중 하나를 사용합니다.
로컬 및 원격 디바이스 instance 핸들을 검색하는 다음 함수 중 하나를 사용하여 CM_Locate_DevNode_Ex, CM_Get_Child_Ex, CM_Get_Parent_Ex 또는 CM_Get_Sibling_Ex 로컬 디바이스 instance 핸들을 검색합니다.

디바이스 설치 함수를 사용하여 로컬 컴퓨터에 바인딩된 디바이스 정보 집합에서 로컬 디바이스 instance 핸들을 가져올 수도 있습니다. 다음 단계를 수행합니다.

로컬 컴퓨터에 바인딩된 디바이스 정보 집합을 가져옵니다. (디바이스 정보 집합에서 가져온 디바이스 instance 핸들은 디바이스 정보 집합이 바인딩된 컴퓨터 핸들에 바인딩됩니다. SP_DEVINFO_LIST_DETAIL_DATA 구조의RemoteMachineHandle 멤버에서 설정된 디바이스 정보에 대한 컴퓨터 핸들을 가져옵니다. 로컬 컴퓨터에 바인딩된 로컬 디바이스 정보 집합의 경우 RemoteMachineHandle 값은 NULL입니다. SetupDiGetDeviceInfoListDetail을 호출하여 SP_DEVINFO_LIST_DETAIL_DATA 구조를 가져옵니다.)
디바이스 정보 집합에서 디바이스 instance 대한 SP_DEVINFO_DATA 구조를 가져옵니다.
SP_DEVINFO_DATA 구조의 DevInst 멤버에서 디바이스 instance 대한 디바이스 instance 핸들을 가져옵니다.

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