Funzione ImmGetDescriptionA (imm.h)

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 richieste 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 necessarie per ricevere la descrizione. Nessuno dei due valori include il carattere null di terminazione. Per Unicode, la funzione restituisce il numero di caratteri Unicode, senza includere il carattere di terminazione Unicode null.

Commenti

Nota

L'intestazione imm.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 che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.

Requisiti

Client minimo supportato	Windows XP [solo app desktop],supporto per la lingua asiatica installata., supporto per la lingua dell'Asia orientale installato.
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	imm.h (include Immdev.h, Windows.h)
Libreria	Imm32.lib
DLL	Imm32.dll

Vedi anche

Gestione metodi di input

Funzioni di Gestione metodi di input