IActiveIMMApp::GetCandidateListW method
Gets a specified candidate list and copies the list to the specified buffer (Unicode implementation).
Syntax
HRESULT GetCandidateListW(
[in] HIMC hIMC,
[in] DWORD dwIndex,
[in] UINT uBufLen,
[out] CANDIDATELIST *pCandList,
[out] UINT *puCopied
);
Parameters
hIMC [in]
A handle to the input context.dwIndex [in]
An unsigned long integer value that contains the zero-based index of the candidate list.uBufLen [in]
An unsigned integer value that contains the size of the buffer, in bytes. If this is zero or if the buffer is insufficient to receive the candidate list, the method returns the size, in bytes, required to receive the complete candidate list to the variable specified by puCopied.pCandList [out]
The address of the CANDIDATELIST structure that receives the candidate list.puCopied [out]
The address of an unsigned integer variable that receives the number of bytes copied to the specified buffer if the buffer is sufficient. Otherwise it receives the size, in bytes, required to receive the complete candidate list.
Return value
Returns S_OK if successful, or an error value otherwise.
Remarks
This method maps to the ImmGetCandidateList function that is documented in the Windows Software Development Kit (SDK).
Requirements
Minimum supported client |
Windows XP |
Minimum supported server |
Windows 2000 Server |
Product |
Internet Explorer 5.0 |
Header |
Dimm.h |
IDL |
Dimm.idl |