IEnumCERTVIEWCOLUMN::GetMaxLength メソッド (certview.h)

[アーティクル]
08/22/2023

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