CDynamicStringAccessor::SetString
The new home for Visual Studio documentation is Visual Studio 2017 Documentation on docs.microsoft.com.
The latest version of this topic can be found at CDynamicStringAccessor::SetString.
Sets the specified column data as a string.
Syntax
HRESULT SetString(
DBORDINAL nColumn,
BaseType* data
) throw( );
HRESULT SetString(
const CHAR* pColumnName,
BaseType* data
) throw( );
HRESULT SetString(
const WCHAR* pColumnName,
BaseType* data
) throw( );
Parameters
nColumn
[in] The column number. Column numbers start with 1. The special value of 0 refers to the bookmark column, if any.
pColumnName
[in] A pointer to a character string that contains the column name.
data
[in] A pointer to the string data to be written to the specified column.
Return Value
A pointer to the string value to which to set the specified column. The value is of type BaseType
, which will be CHAR
or WCHAR
depending on whether _UNICODE
is defined or not.
Remarks
The second override form takes the column name as an ANSI string and the third override form takes the column name as a Unicode string.
If _SECURE_ATL
is defined to have a nonzero value, a runtime assertion failure will be generated if the input data
string is longer than the maximum allowable length of the referenced data column. Otherwise, the input string will be truncated if it is longer than the maximum allowable length.
Requirements
Header: atldbcli.h