Función GlobalAddAtomExA (winbase.h)

  • Artículo

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 que se ha convertido mediante la macro MAKEINTATOM . Vea la sección 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 la función no se realiza correctamente, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError.

Comentarios

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 neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.

Requisitos

   
Plataforma de destino Windows
Encabezado winbase.h (incluya Windows.h)
Library Kernel32.lib
Archivo DLL Kernel32.dll

Vea también

GlobalAddAtom