IEnumCERTVIEWCOLUMN：：GetMaxLength 方法 (certview.h)

發行項
02/26/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)
程式庫	Certidl.lib
Dll	Certadm.dll