Funzione ImmGetCandidateListW (imm.h)
Recupera un elenco di candidati.
Sintassi
DWORD ImmGetCandidateListW(
HIMC unnamedParam1,
[in] DWORD deIndex,
[out, optional] LPCANDIDATELIST lpCandList,
[in] DWORD dwBufLen
);
Parametri
unnamedParam1
[in] deIndex
Indice in base zero dell'elenco dei candidati.
[out, optional] lpCandList
Puntatore a una struttura CANDIDATELIST in cui la funzione recupera l'elenco dei candidati.
[in] dwBufLen
Dimensioni, in byte, del buffer per ricevere l'elenco dei candidati. L'applicazione può specificare 0 per questo parametro se la funzione deve restituire solo le dimensioni necessarie del buffer di output.
Valore restituito
Restituisce il numero di byte copiati nel buffer dell'elenco candidato, se ha esito positivo. Se l'applicazione ha fornito 0 per il parametro dwBufLen, la funzione restituisce le dimensioni necessarie per il buffer dell'elenco candidato.
La funzione restituisce 0 se non riesce.
Osservazioni
Nota
L'intestazione imm.h definisce ImmGetCandidateList 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. |
| server minimo supportato | Windows Server 2003 [solo app desktop] |
| piattaforma di destinazione | Finestre |
| intestazione |
imm.h (include Immdev.h, Windows.h) |
| libreria |
Imm32.lib |
| dll | Imm32.dll |