CM_Get_Child(PDEVINST,DEVINST,ULONG) function

  • Article

[CM_Get_Child is available for use in Windows 2000 and Windows XP. It may be altered or unavailable in subsequent versions. ]

The CM_Get_Child function retrieves the first child of the specified device instance.

DWORD CM_Get_Child(
  PDEVINST pdnDevInst,
  DEVINST dnDevInst,
  ULONG ulFlags
);

Parameters

  • pdnDevInst
    [out] Pointer to a variable that receives the handle to the device instance of the child.
  • dnDevInst
    [in] Handle to the device instance whose child is to be found.
  • ulFlags
    [in] Must be zero.

Return Value

If the function succeeds, the return value is CR_SUCCESS. Otherwise, the return value is one of the following error codes:

CR_FAILURE
CR_INVALID_DEVNODE
CR_INVALID_FLAG
CR_INVALID_POINTER
CR_MACHINE_UNAVAILABLE
CR_NO_SUCH_DEVNODE
CR_REMOTE_COMM_FAILURE

Requirements

Client Requires Windows XP or Windows 2000 Professional.
Server Requires Windows Server 2003 or Windows 2000 Server.
Header

Declared in Cfgmgr32.h.
Library

Use Setupapi.lib.
DLL Requires Setupapi.dll.

See Also

Device Management Functions