IAgentCharacter::GetName

[Microsoft Agent is deprecated as of Windows 7, and may be unavailable in subsequent versions of Windows.]

HRESULT GetName(
   BSTR * pbszName   // address of buffer for character name
);

Retrieves the name of the character.

  • Returns S_OK to indicate the operation was successful.

pbszName

The address of a BSTR that receives the value of the name for the character.

A character's default name is defined when it is compiled with the Microsoft Agent Character Editor. A character's name may vary based on the character's language ID. Characters can be compiled with different names for different languages.

You can also set the character's name using IAgentCharacter:SetName; however, this changes the name for all current clients of the character.

See Also

IAgentCharacter::SetName