Funzione GlobalGetAtomNameW (winbase.h)

Articolo
03/08/2023

Recupera una copia della stringa di caratteri associata all'atomo globale specificato.

Sintassi

UINT GlobalGetAtomNameW(
  [in]  ATOM   nAtom,
  [out] LPWSTR lpBuffer,
  [in]  int    nSize
);

Parametri

[in] nAtom

Tipo: ATOM

Atom globale associato alla stringa di caratteri da recuperare.

[out] lpBuffer

Tipo: LPTSTR

Buffer per la stringa di caratteri.

[in] nSize

Tipo: int

Dimensioni, in caratteri, del buffer.

Valore restituito

Tipo: UINT

Se la funzione ha esito positivo, il valore restituito è la lunghezza della stringa copiata nel buffer, in caratteri, non incluso il carattere Null terminante.

Se la funzione ha esito negativo, il valore restituito è zero. Per informazioni dettagliate sull'errore, chiamare GetLastError.

Commenti

La stringa restituita per un atomo intero (un atomo il cui valore si trova nell'intervallo 0x0001 da 0xBFFF) è una stringa con terminazione null in cui il primo carattere è un segno di sterlina (#) e i caratteri rimanenti rappresentano il valore atomo intero senza segno.

Considerazioni sulla sicurezza

L'uso di questa funzione potrebbe compromettere in modo errato la sicurezza del programma. L'uso errato di questa funzione include non specificare correttamente le dimensioni del parametro lpBuffer . Si noti anche che un atomo globale è accessibile da chiunque; pertanto, la privacy e l'integrità del suo contenuto non sono assicurate.

Nota

L'intestazione winbase.h definisce GlobalGetAtomName come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.

Requisiti


Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	winbase.h (include Windows.h)
Libreria	Kernel32.lib
DLL	Kernel32.dll