IFELanguage 1

 

August 2003

Microsoft Corporation

Summary: This document describes the methods associated with IFELanguage (version 1.0) for Microsoft IME 2003, Japanese version. (3 printed pages)

Contents

HRESULT IFELanguage::Open
HRESULT IFELanguage::Close
HRESULT IFELanguage:: GetPhonetic

Interface ID: IID_IFELanguage

Version 1.0

Note   The following functions are designed to be called by Microsoft® Visual Basic® (Visual Basic for Applications) through TLB.

IFELanguage Methods Description
Open Open the interface to initiate a session
Close Close the interface to terminate a session
GetMorphResult Get morphological analysis result

HRESULT IFELanguage::Open

This method must be called before the use of IFELangauge for initialization.

Parameters:    None

Return Values
HRESULT S_OK: Successfully terminated.
S_FALSE: Fails to create result.

Note Microsoft IME 98 Japanese version has a limitation that multiple processes should not initialize via this call at the same time.

HRESULT IFELanguage::Close

This method must be called after the use of IFELanguage for termination.

Parameters:   None

Return Values
HRESULT S_OK: Successfully terminated.
S_FALSE: Fails to create result.

HRESULT IFELanguage:: GetPhonetic

This converts the input string (which usually contains the Kanji character) to phonetic symbols.

Parameter Description
BSTR string (IN) A string of Kanji characters, to convert to phonetic symbols
LONG start (IN) The number of characters from which IFELanguage begins conversion; the first character is 1 (not 0)
LONG length (IN) The length of characters to convert; if this value is (-1), it means the whole length from the 'start' column is selected
BSTR *phonetic (OUT) The result string; this string is allocated by SysAllocStringLen and must be freed by clients
Return Values
HRESULT S_OK: Successfully terminated.
S_FALSE: Fails to create result.