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


Метод IRecordInfo::GetFieldNames (oaidl.h)

Возвращает имена полей записи.

Синтаксис

HRESULT GetFieldNames(
  [in, out] ULONG *pcNames,
  [out]     BSTR  *rgBstrNames
);

Параметры

[in, out] pcNames

Число возвращаемых имен.

[out] rgBstrNames

Имя массива типа BSTR.

Если параметр rgBstrNames имеет значение NULL, то pcNames возвращается с количеством имен полей.

Параметр rgBstrNames не равен NULL, затем возвращаются строковые имена, содержащиеся в rgBstrNames . Если число имен в pcNames и rgBstrNames не равно, меньшее число — это число возвращаемых имен полей. Вызывающий объект должен освободить BSTR внутри массива, возвращаемого в rgBstrNames.

Возвращаемое значение

Этот метод может возвращать одно из этих значений.

Код возврата Описание
S_OK
Успешно.
E_OUT_OFMEMORY
Недостаточно памяти.
E_INVALIDARG
Один или несколько аргументов недопустимы.

Комментарии

Вызывающий объект должен выделить память для массива BSTR. Если массив больше, чем требуется, задайте для неиспользуемой части значение 0.

При возврате вызывающей стороне потребуется освободить каждый содержащийся BSTR с помощью SysFreeString.

В случае нехватки памяти pcNames указывает на код ошибки.

Требования

   
Целевая платформа Windows
Header oaidl.h

См. также раздел

IRecordInfo

SysFreeString