IMessengerContact::ServiceID Property
Deprecated. Retrieves the service ID, a GUID, for the contact associated with this MessengerContact object.
Syntax
HRESULT IMessengerContact::get_ServiceID(BSTR *pbstrServiceID);
Parameters
- pbstrServiceID
Pointer to a BSTR that contains a GUID that uniquely identifies the service used by this contact. This can be a secondary service contact and therefore may return an ID other than the one for the Microsoft .NET Messenger Service.
Return Value
Returns one of the following values:
S_OK Success. E_INVALIDARG General internal failure. RPC_X_NULL_REF_POINTER pbstrServiceID is a NULL pointer.
Remarks
Clients may wish to compare IMessenger::MyServiceId (the client's service ID) to IMessengerContact::ServiceID. A match of services may allow service-specific functionality that is not possible if the local and remote users are on different services.
Stored service IDs for secondary services may also be useful if it is necessary to create MessengerContact objects that correspond to secondary service contacts (through IMessenger::GetContact, which requires the service ID as a parameter).
Note This property is available for scripting languages.
Important IMessengerContact::ServiceID is no longer available in Windows Vista. See Windows Messenger for more information.
See Also