QueryUserProperty MethodQueryUserProperty Method*
*Contents  *Index  *Topic Contents
*Previous Topic: QueryServerProperty Method
*Next Topic: SendInvitation Method

QueryUserProperty Method

Asynchronously accesses a user property.

Syntax

object.QueryUserProperty UserPropertyName[, Nickname]

Parameters

objectRequired. An object expression that evaluates to an MsChatPr control.
UserPropertyNameRequired. A string expression. Must be one of the following valid user property name values.
Away
Channels
HostInChannels
Identity
IdleTime
IPAddress
Modes
Nickname
OwnerOfChannels
RealName
ServerInfo
ServerName
SignOnTime
UserName
VoiceInChannel
NicknameOptional. A string expression. Can be omitted or empty, in which case the call concerns the control user. If used, the Nickname must be a current server user.

Remarks

A successful QueryUserProperty call results in an OnUserProperty event where UserItems exposes all the known user properties.

Examples

'UserPropertyName and Nickname
MsChatPr1.QueryUserProperty "Away", "Mila" 
'UserPropertyName only
MsChatPr1.QueryUserProperty "SignOnTime"    

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