HRESULT Set(BOOL fGlobal, DWORD dwCmdStart, DWORD dwCmdNum, DWORD dwFlag,
SDATA dData);
Sets information for one or more glossary entries in either the global or application-specific glossary entry set.
· Returns NOERROR if successful, or one of these error values:
E_INVALIDARG
VCMDERR_INVALIDCHAR
VCMDERR_MENUTOOCOMPLEX
VCMDERR_OUTOFDISK
VCMDERR_OUTOFMEM
VCMDERR_VALUEOUTOFRANGE
fGlobal
[in] If this is TRUE, the glossary entries are set in the global glossary entry set that is used in every application; Global glossary entries are saved across invocations. If this is FALSE it only changes glossary entries for the application. In general, applications should not modify the global glossary entry set.
dwCmdStart
[in] Number of the first glossary entry to set. Glossary entry positions are sequential, starting with 1 for the first glossary entry on the menu. If dwFlag is the VCMD_BY_IDENTIFIER value, this parameter is ignored.
dwCmdNum
[in] Either the number of glossary entries to set or the identifier of the glossary entries, depending on the value of dwFlag. If the sum of dwCmdStart and dwCmdNum exceeds the number of glossary entries in the menu, the function sets as many glossary entries as possible.
dwFlag
[in] Flag that identifies the nature of dwCmdNum. This parameter can be one of these values:
VCMD_BY_IDENTIFIER
VCMD_BY_POSITION
dData
[in] SDATA structure that contains a pointer to a data buffer and the size of the buffer. The data buffer contains a list of VCMDCOMMAND structures that describe the voice glossary entries to set. Although they vary in size depending on the glossary entry data, the structures are contiguous within the list. The text that the glossary entries enters into the document is in the description field of the command.