StringLengthFromUser, fonction (usermode_accessors.h)

The StringLengthFromUser function safely calculates the length of a null-terminated string in user-mode memory.

Syntax

SIZE_T StringLengthFromUser(
  const CHAR *String
);

Parameters

String

[in] Pointeur vers une chaîne terminée par null en mémoire en mode utilisateur.

Return value

La fonction retourne la longueur de la chaîne en caractères, sans inclure le caractère null de fin.

Remarks

Cette fonction fournit un accès sécurisé pour calculer la longueur d’une chaîne terminée par null située en mémoire en mode utilisateur. Il est conçu pour être utilisé par le code en mode noyau qui doit déterminer la longueur des chaînes passées à partir d’applications en mode utilisateur.

La fonction garantit que l’adresse de chaîne est une adresse en mode utilisateur valide avant d’effectuer le calcul de longueur. Elle déclenche une exception structurée si l’opération échoue, par exemple lorsque l’adresse de chaîne n’est pas une adresse en mode utilisateur valide ou est inaccessible.

Contrairement aux fonctions de chaîne standard, cette fonction inclut la validation pour empêcher les blocages du noyau lors de l’accès à des pointeurs en mode utilisateur potentiellement non valides. Cela permet de sécuriser la programmation du noyau lors du traitement des données de chaîne en mode utilisateur.

Cette fonction fonctionne sur toutes les versions de Windows, pas seulement sur la dernière version. You need to consume the latest WDK to get the function declaration from the usermode_accessors.h header. You also need the library (umaccess.lib) from the latest WDK. Toutefois, le pilote résultant s’exécutera correctement sur les versions antérieures de Windows.

Requirements

See also

StringLengthFromMode

WideStringLengthFromUser