Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
MySigninName

IMessenger::MySigninName Property

[� The MySigninName property is available for use in Windows Messenger 5.0. It may be unavailable in subsequent versions. Use MySigninName instead. To return a list of MessengerService objects, use the Services property. ]

Deprecated in Windows Messenger 5.0. Sign-in name.

This property is read-only.

Syntax (get)

HRESULT get_MySigninName(
  [out, retval]  BSTR *pbstrName
);

Parameters

pbstrName [out]

Return value. A pointer to a BSTR that contains the current user's sign-in name.

Return Value

Returns one of the following values.

Return codeDescription
S_OK

Success.

RPC_X_NULL_REF_POINTER

pbstrName is a NULL pointer.

E_OUTOFMEMORY

String comparison failed.

E_FAIL

Local client is offline.

MSGR_E_NOT_LOGGED_ON

Client is offline.

 

Remarks

This property fails if the local client is offline. This property does not recheck the user store for the current user's sign-in name. The value returned will be the value entered on the client upon the initial sign-in for this session, which is cleared when the current user signs out.

The Microsoft .NET Messenger Service client can potentially be signed in to multiple services. The client must be signed in to the primary service; if multiple services are enabled, this property returns the sign-in name for the primary service only. For the Microsoft .NET Messenger Service, the sign-in name is a Windows Live ID sign-in name and thus will follow validation rules for e-mail addresses and correspond to a Windows Live ID identity. For other services, the sign-in name may follow different validation rules.

Important  MySigninName is no longer available in Windows Vista. See Windows Messenger for more information.

Note  This property is not available for scripting languages.

Requirements

Header

Msgrua.h

IDL

Msgrua.idl

DLL

Msgsc.dll

See Also

IMessenger
MySigninName

 

 

Send comments about this topic to Microsoft

Build date: 6/30/2010

Community Additions

ADD
Show:
© 2015 Microsoft