Метод IEnumCERTVIEWCOLUMN::GetMaxLength (certview.h)

Статья
02/26/2024

Метод GetMaxLength извлекает максимальную допустимую длину данных столбца в байтах.

Если тип данных столбца PROPTYPE_STRING, разделите количество байтов на sizeof(WCHAR) , чтобы определить максимальное число символов Юникода .

Синтаксис

HRESULT GetMaxLength(
  [out] LONG *pMaxLength
);

Параметры

[out] pMaxLength

Указатель на значение типа LONG , содержащее максимально допустимую длину данных столбца. Эта функция завершится ошибкой, если pMaxLength имеет значение NULL.

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

C++

Если метод завершается успешно, метод возвращает S_OK, а для параметра pMaxLength устанавливается максимально допустимая длина данных столбца.

Если метод завершается сбоем, он возвращает значение HRESULT , указывающее на ошибку. Список распространенных кодов ошибок см. в разделе Общие значения HRESULT.

VB

Возвращаемое значение — это максимально допустимая длина данных столбца в байтах.

Этот метод используется для определения максимально допустимой длины данных для столбца, на который в данный момент ссылается последовательность перечисления столбцов.

Если последовательность перечисления столбцов не ссылается на допустимый столбец, getMaxLength завершится ошибкой . Для перехода по перечислению используйте один из следующих методов:

IEnumCERTVIEWCOLUMN::Reset: перемещается в начало последовательности перечисления.
IEnumCERTVIEWCOLUMN::Next: переходит к следующему столбцу в последовательности перечисления.
IEnumCERTVIEWCOLUMN::Skip: пропускает указанное количество столбцов.

Чтобы определить, индексируются ли данные столбца, вызовите метод IEnumCERTVIEWCOLUMN::IsIndexed .

Примеры

// pEnumCol is previously instantiated IEnumCERTVIEWCOLUMN object
HRESULT  hr;
LONG     nLength;

// determine database length
hr = pEnumCol->GetMaxLength(&nLength);
if (S_OK == hr)
    printf("max length is %d\n", nLength);

Требования

Требование	Значение
Минимальная версия клиента	Ни одна версия не поддерживается
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Целевая платформа	Windows
Header	certview.h (включая Certsrv.h)
Библиотека	Certidl.lib
DLL	Certadm.dll