Share via


IActiveIMMIME::GetCandidateListA method

Gets a specified candidate list and copies the list to the specified buffer. (ANSI implementation).

Syntax

HRESULT GetCandidateListA(
  [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, that is required to receive the complete candidate list to the variable that is 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 that are copied to the specified buffer, if the buffer is sufficient. Otherwise, it receives the size, in bytes, that is 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

Header

Dimm.h

IDL

Dimm.idl

See also

IActiveIMMIME

GetCandidateListW