IEnumCERTVIEWCOLUMN：：GetMaxLength 方法 (certview.h)

项目
02/23/2024

GetMaxLength 方法检索列数据允许的最大长度（以字节为单位）。

如果列数据 的类型PROPTYPE_STRING，请将字节 sizeof(WCHAR) 数除以，以确定 Unicode 字符的最大数目。

语法

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
标头	certview.h (包括 Certsrv.h)
Library	Certidl.lib
DLL	Certadm.dll