Función GlobalAddAtomExW (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 GlobalAddAtomExW(
  [in, optional] LPCWSTR 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 realiza 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 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 Convenciones para prototipos de función.

Requisitos

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

Vea también

GlobalAddAtom