Compartir a través de


IAgentCharacter::SetName

[Microsoft Agent está en desuso a partir de Windows 7 y puede no estar disponible en versiones posteriores de Windows].

HRESULT SetName(
   BSTR bszName   // character name
);

Establece el nombre del carácter.

  • Devuelve S_OK para indicar que la operación se realizó correctamente.

bszName

Un BSTR que establece el nombre del carácter. El nombre predeterminado de un carácter se define cuando se compila con el Editor de caracteres del Agente de Microsoft. Puede cambiarlo mediante IAgentCharacter::SetName; sin embargo, esto cambia el nombre de carácter de todos los clientes actuales del carácter. Esta propiedad no es persistente (almacenada permanentemente). El nombre del carácter vuelve a su nombre predeterminado cada vez que un cliente carga por primera vez el carácter.

El nombre del carácter también puede depender de su identificador de idioma. Los caracteres se pueden compilar con nombres diferentes para distintos idiomas.

El servidor usa el valor de nombre del carácter en partes de la interfaz del Agente de Microsoft, como el título de la ventana Comandos de voz cuando el carácter está activo y en el menú emergente de la barra de tareas de Microsoft Agent.

Consulte también

IAgentCharacter::GetName