Syntaxe
BOOL IsBadStringPtrA(LPCTSTR lpsz, UINT ucchMax);
|
Paramètres
Nom |
Description |
lpsz |
Ce paramètre permet d'indiquer un pointeur vers une chaîne de caractères terminée par un caractère NULL, Unicode ou ASCII. |
ucchMax |
Ce paramètre permet d'indiquer la taille maximale, en caractères, de la chaîne de caractères. La fonction vérifie l'accès en lecture dans tous les octets, jusqu'au caractère NULL de fin de la chaîne de caractères ou jusqu'au nombre d'octets spécifié par ce paramètre, la valeur la plus petite étant retenue. Si ce paramètre est zéro, la valeur de retour est zéro. |
Retour
Valeur |
Description |
0 |
Cette valeur permet d'indiquer que le processus appelant dispose d'un accès en lecture à tous les octets jusqu'au caractère NULL de fin de la chaîne de caractères ou jusqu'au nombre d'octets spécifié par ucchMax. |
0 != |
Ces valeurs permettent d'indiquer que le processus appelant n'a pas d'accès en lecture à tous les octets, jusqu'au caractère NULL de fin de la chaîne de caractères ou jusqu'au nombre d'octets spécifié par ucchMax. Pour obtenir des informations d'erreur étendues, appelez la fonction GetLastError. |
Description
Cette fonction permet de vérifier que l'appel du processus à un accès en lecture dans les rangs de mémoire pointer sur une chaine de caractères.
Remarque
- Si le processus appelant dispose d'un accès en lecture à certains des octets de la plage de mémoire spécifiée, mais pas à tous, la valeur renvoyée est différente de zéro.
- Dans un environnement multitâche préemptif, il est possible qu'un autre processus léger modifie l'accès du processus à la mémoire en cours de test. Même lorsque la fonction indique que
le processus a un accès en lecture à la mémoire spécifiée, vous devez utiliser la gestion structurée des exceptions lorsque vous tentez d'accéder à la mémoire. L'utilisation de la gestion
structurée des exceptions permet au système d'avertir le processus si une exception de violation d'accès se produit, cette situation donnant au processus la possibilité de gérer l'exception.
Voir également
Langage de programmation - C pour Windows - API de Windows - IsBadCodePtr
Langage de programmation - C pour Windows - API de Windows - IsBadHugeReadPtr
Langage de programmation - C pour Windows - API de Windows - IsBadHugeWritePtr
Langage de programmation - C pour Windows - API de Windows - IsBadReadPtr
Langage de programmation - C pour Windows - API de Windows - IsBadWritePtr
Dernière mise à jour : Dimanche, le 6 décembre 2015