CONFIGMG_Get_Device_ID

CONFIGMG_Get_Device_ID_Size

CONFIGRET CONFIGMG_Get_Device_ID_Size(PFARULONG pulLen, DEVNODE dnDevNode, ULONG ulFlags)

Retrieves the size of a device identifier from a device node.

Returns CR_SUCCESS if the function is successful. Otherwise, the return value can be CR_INVALID_DEVNODE, CR_INVALID_FLAG or CR_INVALID_POINTER.

pulLen

Address that receives the length of the device identifier. This length does not include the null-terminating character. This address is filled with zeroes if there is no identifier. The length is always less than or equal MAX_DEVICE_ID_LEN.

dnDevNode

Handle of a device node.

ulFlags

Must be zero.

The device node's device identifier is built from the identifier of the enumerator immediately above this device in the hardware tree, this device's identifier, and this device's instance. For example, the device identifier for an Adaptec 1540c might be \isaenum\aha1540c\1. This string is used as the direct key for access into the registry. The device identifier is limited to MAX_DEVICE_ID_LEN bytes.