RtlStringCchLengthW-Funktion (ntstrsafe.h)

Artikel
02/07/2025

Die RtlStringCchLengthW- und RtlStringCchLengthA- Funktionen bestimmen die Länge einer angegebenen Zeichenfolge in Zeichen.

Syntax

NTSTRSAFEDDI RtlStringCchLengthW(
  [in] STRSAFE_PCNZWCH psz,
  [in] size_t          cchMax,
       size_t          *pcchLength
);

Parameter

[in] psz

Ein Zeiger auf einen Puffer, der eine mit Null beendete Zeichenfolge enthält, deren Länge überprüft wird.

[in] cchMax

Die maximale Anzahl der zulässigen Zeichen im Puffer, auf die pszverweist, einschließlich des endierenden NULL-Zeichens. Dieser Wert darf NTSTRSAFE_MAX_CCH nicht überschreiten.

pcchLength

Wenn der Aufrufer einen Nicht-NULL- Adresszeiger bereitstellt, lädt die Funktion die Adresse mit der Länge in Zeichen der Zeichenfolge, die im Puffer enthalten ist. Die Länge enthält nicht das endende Nullzeichen der Zeichenfolge.

Rückgabewert

Die Funktion gibt einen der NTSTATUS-Werte zurück, die in der folgenden Tabelle aufgeführt sind. Informationen zum Testen von NTSTATUS-Werten finden Sie unter Verwenden von NTSTATUS-Werten.

Rückgabecode	Beschreibung
STATUS_SUCCESS	Dieser Erfolgsstatus bedeutet, dass die Zeichenfolge bei psz nicht NULL-war und die Länge der Zeichenfolge (einschließlich des endierenden Nullzeichens) kleiner oder gleich cchMax Zeichen ist.
STATUS_INVALID_PARAMETER	Dieser Fehlerstatus bedeutet, dass der Wert in pszNULL-ist, cchMax größer als NTSTRSAFE_MAX_CCH ist oder psz länger als cchMaxist.

Bemerkungen

RtlStringCchLengthW und RtlStringCchLengthA- sollten anstelle strlenverwendet werden. Sie werden verwendet, um sicherzustellen, dass eine Zeichenfolge in Zeichen nicht größer als eine bestimmte Länge ist. Wenn diese Bedingung erfüllt ist, geben RtlStringCchLengthW und RtlStringCchLengthA die aktuelle Länge der Zeichenfolge in Zeichen zurück, nicht einschließlich des endenden NULL-Zeichens.

Verwenden Sie RtlStringCchLengthW- zum Behandeln von Unicode-Zeichenfolgen und RtlStringCchLengthA- zum Behandeln von ANSI-Zeichenfolgen. Das von Ihnen verwendete Formular hängt von Ihren Daten ab, wie in der folgenden Tabelle dargestellt.

Zeichenfolgendatentyp	Zeichenfolgenliteral	Funktion
WCHAR	L"string"	RtlStringCchLengthW
Zeichen-	"string"	RtlStringCchLengthA

Weitere Informationen zu den sicheren Zeichenfolgenfunktionen finden Sie unter Verwenden von Funktionen für sichere Zeichenfolgen.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Verfügbar in Windows XP mit Service Pack 1 (SP1) und höheren Versionen von Windows.
Zielplattform-	Desktop
Header-	ntstrsafe.h (include Ntstrsafe.h)
Library	Ntstrsafe.lib
IRQL-	Wenn Zeichenfolgen, die bearbeitet werden, immer im Arbeitsspeicher vorhanden sind, andernfalls PASSIVE_LEVEL

Siehe auch

RtlStringCbLength

Freigeben über