OLEDBSimpleProvider::getRWStatus

Returns the read/write status of a specified column, row, cell, or data set. If one or both of iRow and iColumn have a value of -1, the read/write status is returned for the entire column, row, or complete data set.

getRWStatus uses the following enumeration:

typedef enum OSPRW {
   OSPRW_READONLY = 0,
   OSPRW_DEFAULT = 1,
   OSPRW_READWRITE = 1,
   OSPRW_MIXED = 2
};

The preceding values are defined in the following table.

Value	Meaning
OSPRW_READONLY	Cell, row, column, or data set is read-only.
OSPRW_DEFAULT OSPRW_READWRITE	Cell, row, column, or data set can be modified (the default).
OSPRW_MIXED	Cell, row, column, or data set read/write status is unknown; or row, column, or data set is of mixed status.

HRESULT getRWStatus (
   LONG       iRow,
   LONG       iColumn,
   OSPRW     *prwStatus);

Parameters

iRow: [in]
Position of the specified row. A value of -1 indicates all rows.
iColumn: [in]
Position of the specified column. A value of -1 indicates all columns.
prwStatus: [out]
Enumerated value indicating the returned read/write status of a specified cell, row, column, or data set. (See above table for descriptions.)

Return Codes

S_OK: The method succeeded.
E_FAIL: A provider-specific error occurred.

Comments

If the *prwStatus is OSPRW_MIXED, most callers will treat it as read/write (OSPRW_READWRITE). A "lazy" provider should return a *prwStatus value of OSPRW_MIXED.