IMessengerContact::ServiceName Property

  • Article

Deprecated. Retrieves the service name of the contact associated with this MessengerContact object.

Syntax

HRESULT IMessengerContact::get_ServiceName(BSTR *pbstrServiceName);

Parameters

  • pbstrServiceName
    Pointer to a BSTR that contains a string that identifies the service used by this contact.

Return Value

Returns one of the following values: 

S_OK Success.
E_FAIL General internal failure.
E_OUTOFMEMORY Internal string copy failed.
RPC_X_NULL_REF_POINTER pbstrServiceName is a NULL pointer.
E_NOTIMPL Cannot be accessed through scripting.

Remarks

This method is useful for obtaining human-readable, service-identifying strings to be used in the user interface (UI). The service ID (obtained through IMessengerContact::ServiceID) will be more useful in the Microsoft Windows Messenger APIs.

Note  This property is available for scripting languages.

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

See Also

IMessenger::MyServiceName