GetParticipantRealName Method


		Contents Index Topic Contents
	Previous Topic: ExitRoom Method Next Topic: InviteParticipant Method

GetParticipantRealName Method

Gets the real name of a participant by using the member's participant ID or alias (nickname).
Syntax
object.GetParticipantRealName ParticipantID, Alias, Synchronous, RealName
Parameters

object Required. An object expression that evaluates to a Chat control.

ParticipantID Required. A long integer value that indicates which member's real name is being requested. If ParticipantID is set to -1, the method uses the selected member's participant ID in the Participant list box. If ParticipantID is not set to -1, the participant ID must have come from an OnEnterParticipant event. This value must be set to zero if the application is requesting the real name by using the member's alias.

Alias Required. A BSTR value that contains the requested member's alias. This value must be set to an empty string if the application is requesting the real name by using the member's ParticipantID.

Synchronous Required. A Boolean value that indicates whether this method is executed synchronously or asynchronously. If Synchronous is set to TRUE, the real name is put into the string that is pointed to by RealName for a Visual Basic or C/C++ application. If Synchronous is set to FALSE, the answer to the query comes back asynchronously. If the query is successful, the OnParticipantRealName event returns the information. If the query is not successful, the OnError event is triggered. VBScript does not support pointers, so Synchronous must be set to FALSE.

RealName Required. An address of a string where the real name of the member will be stored if the method is executed synchronously.

Remarks

When using ParticipantID, the scope of the search is limited to members currently in the chat room. When using Alias, the entire server is searched.

See Also

ThisParticipantID, ThisParticipantAlias

Top of Page
© 1997 Microsoft Corporation. All rights reserved. Terms of Use.

object	Required. An object expression that evaluates to a Chat control.
ParticipantID	Required. A long integer value that indicates which member's real name is being requested. If ParticipantID is set to -1, the method uses the selected member's participant ID in the Participant list box. If ParticipantID is not set to -1, the participant ID must have come from an OnEnterParticipant event. This value must be set to zero if the application is requesting the real name by using the member's alias.
Alias	Required. A BSTR value that contains the requested member's alias. This value must be set to an empty string if the application is requesting the real name by using the member's ParticipantID.
Synchronous	Required. A Boolean value that indicates whether this method is executed synchronously or asynchronously. If Synchronous is set to TRUE, the real name is put into the string that is pointed to by RealName for a Visual Basic or C/C++ application. If Synchronous is set to FALSE, the answer to the query comes back asynchronously. If the query is successful, the OnParticipantRealName event returns the information. If the query is not successful, the OnError event is triggered. VBScript does not support pointers, so Synchronous must be set to FALSE.
RealName	Required. An address of a string where the real name of the member will be stored if the method is executed synchronously.