IContentListSchema::get_ColumnFlags, put_ColumnFlags

IContentListSchema::get_ColumnFlags, put_ColumnFlags

Commerce Server 2000
Ee785577.c++_off(en-US,CS.10).gif Ee785577.vb_on(en-US,CS.10).gif

The ColumnFlags property is a read/write long that contains the column flags.


Get method:

HRESULT IContentListSchema::get_ColumnFlags(
VARIANT vColumn,
long* ColumnFlags

Put method:

HRESULT IContentListSchema::put_ColumnFlags(
VARIANT vColumn,
long ColumnFlags



[in] A VARIANT that contains either the column name or the column position in order to identify the column in question. Column positions are counted from zero (0), not one (1).


[in] When setting the property, a long that contains the new column flag settings, represented as a bit field.
[out,retval] When getting the property, a pointer to a long used to return the current column flag settings, represented as a bit field.

Return Values

These methods return an HRESULT indicating whether or not they completed successfully. See the Error Values section for more details.

Error Values

These methods return S_OK (0x00000000) to indicate success and standard COM HRESULT error values to indicate failure. For more information about standard COM errors, see Standard COM Errors. Additional information may be available using the global Err object, which can be accessed using the API function GetErrorInfo. In particular, the GetDescription method of the IErrorInfo interface may return a text description of the error.


Column flags are represented as a bit field. The following table shows the meanings of the bits that are used and the constants provided for manipulating those bits.

1CLCOL_READONLY (= 0x01)When the bit is set, data in the column is read-only, and cannot be updated. This will be common for data stored in the ContentListFactory object since that data is shared between multiple page requests.

When the bit is cleared, data in the column is read/write, and can be freely updated. No record locking is performed, so update contention could occur when updating data in the ContentListFactory object. This is not a concern for columns that are marked Private since they exist in the individual instances of ContentList objects, and ContentList objects are typically created for and used by a single thread.

2CLCOL_PRIVATE (= 0x02)When the bit is set, the data in the column is private to each ContentList object based on this schema. This means that the data is stored separately in each ContentList object that is created, and not stored in the shared columns in the corresponding ContentListFactory object.
4CLCOL_SCORE_COLUMN (= 0x04)When the bit is set it indicates that the data in this column is the score value associated with the content item. The type of this column must be a single-precision floating-point type (CLCOL_R4); only one column in the schema can have this flag set. Further, since a unique score value must be associated with each individual page request, this bit can only be set in conjunction with the CLCOL_PRIVATE bit.

In other words, it must be a column stored in the ContentList object, as opposed to the ContentListFactory object, that is marked as the score column.

See Also

ContentListSchema Object

All rights reserved.
© 2016 Microsoft