IMessengerContact::Property Property

  • Article

Deprecated. Reserved.

Syntax

HRESULT IMessengerContact::get_Property(MPHONE_TYPE ePropType, VARIANT *pvPropVal);
HRESULT IMessengerContact::put_Property(MPHONE_TYPE ePropType, VARIANT vPropVal);

Parameters

  • ePropType
    MCONTACTPROPERTY constant value.
  • pvPropVal
    A pointer to a VARIANT that contains the property value. (Variant type differs depending on the property being set or retrieved.)
  • ePropType
    MCONTACTPROPERTY constant value.
  • vPropVal
    A VARIANT used to set the property value. (Variant type differs depending on the property being set or retrieved.)

Return Value

Returns one of the following values: 

S_OK Success.
E_INVALIDARG ePropType is out of range (not within MCONTACTPROPERTY range).
RPC_X_NULL_REF_POINTER vPropVal is a NULL pointer.

Remarks

The bstrNumber return value may contain punctuation. Most APIs used for Internet telephony will either ignore or strip punctuation.

E_FAIL HRESULT will be returned for a contact who does not have phone information for the specified PhoneType parameter.

Note  This property is not available for scripting languages.

Important  IMessengerContact::Property is no longer available in Windows Vista. See Windows Messenger for more information.

See Also

DMessengerEvents::OnContactPagerChange