IEnumCERTVIEWCOLUMN::GetMaxLength-Methode (certview.h)

Artikel
02/26/2024

Die GetMaxLength-Methode ruft die maximal zulässige Länge in Bytes für die Spaltendaten ab.

Wenn der Typ der Spaltendaten PROPTYPE_STRING ist, dividieren Sie die Anzahl der Bytes durch sizeof(WCHAR) , um die maximale Anzahl von Unicode-Zeichen zu bestimmen.

Syntax

HRESULT GetMaxLength(
  [out] LONG *pMaxLength
);

Parameter

[out] pMaxLength

Ein Zeiger auf einen Wert vom Typ LONG , der die maximal zulässige Länge für die Spaltendaten enthält. Diese Funktion schlägt fehl, wenn pMaxLengthNULL ist.

Rückgabewert

C++

Wenn die Methode erfolgreich ist, gibt die Methode S_OK zurück, und pMaxLength wird auf die maximal zulässige Länge für die Spaltendaten festgelegt.

Wenn die Methode fehlschlägt, gibt sie einen HRESULT-Wert zurück, der den Fehler angibt. Eine Liste allgemeiner Fehlercodes finden Sie unter Allgemeine HRESULT-Werte.

VB

Der Rückgabewert ist die maximal zulässige Länge in Bytes für die Spaltendaten.

Hinweise

Diese Methode wird verwendet, um die maximal zulässige Datenlänge für die Spalte zu bestimmen, auf die derzeit durch die Spaltenenumerationssequenz verwiesen wird.

Wenn die Spaltenenumerationssequenz nicht auf eine gültige Spalte verweist, schlägt GetMaxLength fehl. Verwenden Sie eine der folgenden Methoden, um durch die Enumeration zu navigieren:

IEnumCERTVIEWCOLUMN::Reset: Wird an den Anfang der Enumerationssequenz verschoben.
IEnumCERTVIEWCOLUMN::Next: Wechselt zur nächsten Spalte in der Enumerationssequenz.
IEnumCERTVIEWCOLUMN::Skip: Überspringt eine angegebene Anzahl von Spalten.

Rufen Sie die IEnumCERTVIEWCOLUMN::IsIndexed-Methode auf, um festzustellen, ob die Spaltendaten indiziert sind.

Beispiele

// 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);

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Nicht unterstützt
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	certview.h (include Certsrv.h)
Bibliothek	Certidl.lib
DLL	Certadm.dll