Funzione ImmGetDescriptionA (immdev.h)

Articolo
11/20/2024

Copia la descrizione dell'IME nel buffer specificato.

Sintassi

UINT ImmGetDescriptionA(
                  HKL   unnamedParam1,
  [out, optional] LPSTR lpszDescription,
  [in]            UINT  uBufLen
);

Parametri

unnamedParam1

[out, optional] lpszDescription

Puntatore a un buffer in cui la funzione recupera la stringa con terminazione Null che descrive l'IME.

[in] uBufLen

Dimensioni, in caratteri, del buffer di output. L'applicazione imposta questo parametro su 0 se la funzione restituisce le dimensioni del buffer necessarie per la descrizione completa, escluso il carattere null di terminazione.

Windows NT, Windows 2000, Windows XP: Le dimensioni del buffer sono in caratteri Unicode, ognuna costituita da due byte. Se il parametro è impostato su 0, la funzione restituisce le dimensioni del buffer richiesto nei caratteri Unicode, escluso il carattere Null di terminazione Unicode.

Valore restituito

Restituisce il numero di caratteri copiati nel buffer di output. Se l'applicazione imposta il parametro uBufLen su 0, la funzione restituisce le dimensioni del buffer necessario per ricevere la descrizione. Nessuno dei due valori include il carattere Null di terminazione. Per Unicode, la funzione restituisce il numero di caratteri Unicode, non incluso il carattere Null di terminazione Unicode.

Osservazioni

Nota

L'intestazione immdev.h definisce ImmGetDescription come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows XP [solo app desktop],è installato il supporto per la lingua dell'Asia orientale. È stato installato il supporto per la lingua dell'Asia orientale.
server minimo supportato	Windows Server 2003 [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	immdev.h (include Immdev.h, Windows.h)
libreria	Imm32.lib
dll	Imm32.dll

Vedere anche

di Gestione metodi di input

funzioni di Gestione metodi di input

Condividi tramite