C pour Windows - API de Windows

AddAtomA	kernel32.dll	Ajoute un atome
Windows 9X, NT 3.1+, 2000, XP, 2003

ATOM AddAtomA(LPCSTR lpString);

Nom	Description
lpString	Ce paramètre permet d'indiquer l'adresse de la chaîne de caractères à ajouter.

Valeur	Description
0	Cette valeur permet d'indiquer qu'une erreur s'est produite, dans ce cas il faudrait consulter la fonction GetLastError pour obtenir plus de détails.
1 à 65535	Ces valeurs permettent d'indiquer le Handle associé à l'Atom.

Cette fonction permet d'ajouter une chaine de caractères ASCIZ à l'Atom global.

La fonction AddAtomA n'entrepose pas plus d'une copie d'une chaîne de caractères spécifiée dans la table Atom. Si la chaîne de caractères est déjà dans la table, la fonction renvoie l'Atom existant et, dans le cas d'un Atom de chaîne de caractères, incrémente le compte de références de la chaîne de caractères.
Si lpString a le format "#1234", la fonction AddAtomA renvoie un Atom entier dont la valeur est la représentation sur 16 bits du nombre décimal spécifié dans la chaîne de caractères (0x04D2, dans cet exemple). Si la valeur décimale spécifiée est 0x0000 ou est supérieure ou égale à 0xC000, alors la valeur renvoyée est 0, cette situation indiquant une erreur. Si lpString a été créé par la macro MAKEINTATOM, le mot de poids faible doit être compris entre 0x0001 et 0xBFFF. Si le mot de poids faible ne se trouve pas dans cette intervalle, alors la fonction échoue.
Si lpString a une autre forme, alors AddAtomA renvoie un Atom de chaîne de caractères.

Dernière mise à jour : Samedi, 5 décembre 2015

Section courante