Fonction RtlStringCchLengthA (ntstrsafe.h)

Article
02/07/2025

Les fonctions RtlStringCchLengthW et RtlStringCchLengthA déterminent la longueur, en caractères, d’une chaîne fournie.

Syntaxe

NTSTRSAFEDDI RtlStringCchLengthA(
  [in] STRSAFE_PCNZCH psz,
  [in] size_t         cchMax,
       size_t         *pcchLength
);

Paramètres

[in] psz

Pointeur vers une mémoire tampon qui contient une chaîne terminée par null, dont la longueur sera vérifiée.

[in] cchMax

Nombre maximal de caractères autorisés dans la mémoire tampon pointée par psz, y compris le caractère null de fin. Cette valeur ne peut pas dépasser NTSTRSAFE_MAX_CCH.

pcchLength

Si l’appelant fournit un pointeur d’adressenull non NULL, la fonction charge l’adresse avec la longueur, en caractères, de la chaîne contenue dans la mémoire tampon. La longueur n’inclut pas le caractère null de fin de la chaîne.

Valeur de retour

La fonction retourne l’une des valeurs NTSTATUS répertoriées dans le tableau suivant. Pour plus d’informations sur la façon de tester des valeurs NTSTATUS, consultez Using NTSTATUS Values.

Retourner le code	Description
STATUS_SUCCESS	Cet état de réussite signifie que la chaîne à psz n’a pas été NULL et que la longueur de la chaîne (y compris le caractère null de fin) est inférieure ou égale à caractères cchMax.
STATUS_INVALID_PARAMETER	Cet état d’erreur signifie que la valeur dans psz est NULL , cchMax est supérieure à NTSTRSAFE_MAX_CCH, ou psz est plus long que cchMax.

Remarques

RtlStringCchLengthW et RtlStringCchLengthA doit être utilisé au lieu de strlen. Ils sont utilisés pour s’assurer qu’une chaîne n’est pas supérieure à une longueur donnée, en caractères. Si cette condition est remplie, RtlStringCchLengthW et RtlStringCchLengthA retourner la longueur actuelle de la chaîne en caractères, sans inclure le caractère null de fin.

Utilisez RtlStringCchLengthW pour gérer les chaînes Unicode et RtlStringCchLengthA pour gérer les chaînes ANSI. Le formulaire que vous utilisez dépend de vos données, comme indiqué dans le tableau suivant.

Type de données de chaîne	Littéral de chaîne	Fonction
WCHAR	L"string »	RtlStringCchLengthW
char	« string »	RtlStringCchLengthA

Pour plus d’informations sur les fonctions de chaîne sécurisée, consultez Using Safe String Functions.

Exigences

Exigence	Valeur
client minimum pris en charge	Disponible dans Windows XP avec Service Pack 1 (SP1) et versions ultérieures de Windows.
plateforme cible	Bureau
d’en-tête	ntstrsafe.h (include Ntstrsafe.h)
bibliothèque	Ntstrsafe.lib
IRQL	Si les chaînes manipulées résident toujours en mémoire, sinon PASSIVE_LEVEL

Voir aussi

RtlStringCbLength

Partager via