IMessenger::MyPhoneNumber property

[MyPhoneNumber is no longer available for use as of Windows Vista. See Windows Messenger for more information.]

Retrieves the stored phone number of the local client user.

This property is read-only.

Syntax

HRESULT get_MyPhoneNumber(
  [in]          MPHONE_TYPE PhoneType,
  [out, retval] BSTR        *pbstrNumber
);

Property value

A string (not a numeric data type) that contains the requested phone number. This number may contain punctuation, depending on how the data was collected.

Error codes

Returns one of the following values.

Name Meaning
S_OK
Success.
RPC_X_NULL_REF_POINTER
pbstrNumber is a NULL pointer.
MSGR_E_NOT_LOGGED_ON
Client was not signed in to the primary service at the time this method was called.
E_FAIL
The requested phone number does not exist. pbstrNumber will be a NULL string.

Remarks

Note

This property is not available for scripting languages.

Requirements

End of client support
Windows XP
End of server support
Windows Server 2003
Header
Msgrua.h
IDL
Msgrua.idl
DLL
Msgsc.dll

See also

IMessenger

Phone