SpObjectToken SetId Method

Microsoft Speech SDK

Intelligent Interface Technologies Home Page Microsoft Speech SDK

Speech Automation 5.1

Object: SpObjectToken
Type: Hidden

SetId Method


The SetId method associates a new object token with a resource by setting its ID property.

The ID of an SpObjectToken object is the path to its folder within the Speech configuration database.

The Id property of an SpObjectToken can be set once. Subsequent SetId calls will return the error message, SPERR_ALREADY_INITIALIZED. Attempting to use an SpObjectToken object before setting its Id property will return SPERR_UNINITIALIZED.


SpObjectToken.SetId(
     Id As String,
     [CategoryID As String],
     [CreateIfNotExist As Boolean = False]
)

Parameters

Id
The ID of the token.
CategoryID
[Optional] The category ID of the token. By default the value is the empty string value of "".
CreateIfNotExist
[Optional] Specifies creating the token. If True, the folder is created if one does not already exist. By default the value is False, and no folder is created.

Return Value

None.


Example

Use of the RemoveStorageFileName method is demonstrated in the code example for the GetStorageFileName method.