CONFIGMG_Read_Registry

CONFIGMG_Read_Registry_Value

CONFIGRET CONFIGMG_Read_Registry_Value(DEVNODE dnDevNode, PFARCHAR pszSubKey, PFARCHAR pszValueName, ULONG ulExpectedType, PFARVOID Buffer, PFARULONG pulLength, ULONG ulFlags)

Retrieves a value in the registry.

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

dnDevNode

Handle of a device node. The devnode can have a NULL device ID, but in this case, CR_NO_SUCH_VALUE is returned.

pszSubKey

Name of the subkey. Can be NULL if none.

pszValueName

Name of the value.

ulExpectedType

Either REG_SZ if a string is wanted or REG_BINARY if a binary value is wanted.

Buffer

Address of the buffer that receives the registry data. This can be NULL if you just want to get the size of the value.

pulLength

The length of the buffer (both input and output).

ulFlags

Must be a combination of the following:

CM_REGISTRY_HARDWARE	Select the hardware branch.
CM_REGISTRY_SOFTWARE	Select the software branch.
CM_REGISTRY_USER	Use HKEY_CURRENT_USER.
CM_REGISTRY_CONFIG	Use HKEY_CURRENT_CONFIG.

See also CONFIGMG_Write_Registry_Value