II3ID::ReadProfileString Method

Synopsis

This method reads a string value from the registry. To retrieve a value, specify the name of a section and the name of an entry, as if you were reading an INI file. Use II3ID::WriteProfileString to write a string to the registry.

IDL Function Prototype

HRESULT ReadProfileString(

   [in] BSTR Section,

   [in] BSTR Entry,

   [in, optional, defaultvalue(NULL)] BSTR DefaultValue, 

   [out, retval] BSTR * Value

);

C/C++ Syntax

HRESULT ReadProfileString(BSTR Section, BSTR Entry, BSTR DefaultValue, BSTR * Value);

Parameters

Section

is an arbitrary string that defines a location in the registry (e.g.: Employees)

Entry

Entry is the name of the item whose value you wish to retrieve (e.g. John Doe).

DefaultValue

This optional default value is used when no value is returned by the read operation.

Value

The return value is a string.