Поделиться через

Запись пользователя

  • Статья

Примечание.

Мастер поставщика OLE DB в ATL недоступен в Visual Studio 2019 и более поздних версиях.

Запись пользователя предоставляет структуру кода и данных, представляющую собой данные столбца для набора строк. Запись пользователя может создаваться во время компиляции или выполнения. При создании поставщика с помощью службы Мастер поставщика ATL OLE DB мастер создает запись пользователя по умолчанию, которая выглядит следующим образом (при условии, что указано имя поставщика [короткое имя] из MyProvider).

class CWindowsFile:
   public WIN32_FIND_DATA
{
public:
  
BEGIN_PROVIDER_COLUMN_MAP(CMyProviderWindowsFile)
   PROVIDER_COLUMN_ENTRY("FileAttributes", 1, dwFileAttributes)
   PROVIDER_COLUMN_ENTRY("FileSizeHigh", 2, nFileSizeHigh)
   PROVIDER_COLUMN_ENTRY("FileSizeLow", 3, nFileSizeLow)
   PROVIDER_COLUMN_ENTRY_STR("FileName", 4, cFileName)
   PROVIDER_COLUMN_ENTRY_STR("AltFileName", 5, cAlternateFileName)
END_PROVIDER_COLUMN_MAP()
  
};

При взаимодействии с клиентом шаблоны поставщика OLE DB обрабатывают все особенности OLE DB. Чтобы получить данные столбца, необходимые для ответа, поставщик вызывает функцию GetColumnInfo, которую необходимо поместить в запись пользователя. Вы можете использовать явное переопределение GetColumnInfo в пользовательской записи, например, объявив ее в H-файл, как описано в этом примере.

template <class T>
static ATLCOLUMNINFO* GetColumnInfo(T* pThis, ULONG* pcCols)

Это соответствует следующему.

static ATLCOLUMNINFO* GetColumnInfo(CommandClass* pThis, ULONG* pcCols)
static ATLCOLUMNINFO* GetColumnInfo(RowsetClass* pThis, ULONG* pcCols)

Затем запустите GetColumnInfo в CPP-файле записи пользователя.

Макросы PROVIDER_COLUMN_MAP упрощают создание функции GetColumnInfo.

  • BEGIN_PROVIDER_COLUMN_MAP определяет прототип функции и статический массив структур ATLCOLUMNINFO.

  • PROVIDER_COLUMN_ENTRY определяет и инициализирует отдельную ATLCOLUMNINFO.

  • END_PROVIDER_COLUMN_MAP закрывает массив и функцию. Он также перемещает число элементов массива в параметр pcCols.

При создании записи пользователя во время GetColumnInfo выполнения использует pThis параметр для получения указателя на набор строк или экземпляр команд. Команды и наборы строк должны поддерживать интерфейс IColumnsInfo, поэтому из этого указателя может быть взята информация о столбце.

Команда CommandClass и набор строк RowsetClass используют эту запись пользователя.

Более подробный пример переопределения GetColumnInfo в записи пользователя см. в статье Dynamically Determining Columns Returned to the Consumer (Динамично определяемые столбцы, возвращенные объекту-получателю).

См. также

Архитектура шаблона поставщика OLE DB