Función GlobalAddAtomExA (winbase.h)

Agrega una cadena de caracteres a la tabla atom global y devuelve un valor único (un átomo) que identifica la cadena.

Sintaxis

ATOM GlobalAddAtomExA(
  [in, optional] LPCSTR lpString,
  [in]           DWORD  Flags
);

Parámetros

[in, optional] lpString

Cadena terminada en NULL que se va a agregar. La cadena puede tener un tamaño máximo de 255 bytes. Las cadenas que solo difieren en el caso se consideran idénticas. El caso de la primera cadena de este nombre agregado a la tabla se conserva y devuelve mediante la función globalGetAtomName .

Como alternativa, puede usar un átomo entero convertido mediante la macro MAKEINTATOM . Consulte los comentarios para obtener más información.

[in] Flags

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es el átomo recién creado.

Si se produce un error en la función, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError.

Observaciones

Nota

El encabezado winbase.h define GlobalAddAtomEx como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.

Requisitos

Requisito	Valor
de la plataforma de destino de	Windows
encabezado de	winbase.h (incluya Windows.h)
biblioteca de	Kernel32.lib
DLL de	Kernel32.dll

Consulte también

GlobalAddAtom