IERegGetDw

Reads an Internet Explorer registry setting that’s defined to have REG_DWORD type.

Declaration

HRESULT 
IERegGetDw (
    UINT uSetting,
    DWORD *pdwData);

Parameters

The uSetting argument is an index that identifies the setting. For a list of supported settings, see the general notes on the Internet Explorer Registry API.

The pdwData argument provides the address of a variable that is to receive the setting’s REG_DWORD data.

Return Value

The function returns zero for success, else an error code.

Behaviour

If pdwData is NULL, the function cannot do anything useful, and fails (returning E_FAIL).

If the given index is unsupported, the function fails (returning 0x80040704).

The function looks for the indicated setting at its allowed locations in the registry. It ignores values that are present but whose data does not have the type that is defined for that setting. Register errors while looking for a value just mean the value is not present. The function succeeds if either

• a value is found and has REG_DWORD data
• or no value is found but the setting provides a REG_DWORD default.

Possible error codes from the registry search are:

• 0x80040700 if the value is not found and does not have a default;
• 0x80040701 if the value is found or defaulted, but its data is not of type REG_DWORD.

Availability

The IERegGetDw function is exported from IERTUTIL as ordinal 151 in version 8.0 and higher.