The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

IOptionDescription::Id property

Gets the identifier of the spell checker option.

This property is read-only.

Syntax

C++


HRESULT get_Id(
  [out, retval] LPWSTR *value
);

Property value

The option id. This is never the empty string or a null pointer.

Error codes

Name	Meaning
S_OK	Successful.

Remarks

Option identifiers all exist in the same area. Spell checker providers should use the engine identifier and the language tag (if the option is language-specific) to disambiguate potential collisions. Specifically, the structure for naming the option identifiers should be:

For the Microsoft spell checker engine: <language tag>:<option name>. For example, "pt-BR:2009Reform."
For spell check provider engines: <engine id>:<language tag>:<option name> (the language tag may be omitted if the option is not language specific). For example, "samplespell:fr-FR:AccentedUppercase".

Note Spell check providers are allowed to support existing Microsoft option identifiers, but they must not create new option identifiers in the Microsoft namespace. That is, spell check providers must use the engine identifier as a prefix.

An option identifier is linked to the set of labels and the semantics associated with them. If any change needs to be made between versions to the option (adding a label to the set of labels), a new option with a new identifier must be used. The only valid change that does not require a new identifier is to change from a single label to two labels and vice-versa when the semantics for values 0 and 1 do not change.

Requirements

Minimum supported client	Windows 8 [desktop apps \| Windows Store apps]
Minimum supported server	Windows Server 2012 [desktop apps \| Windows Store apps]
Header	Spellcheck.h
IDL	Spellcheck.idl