IMsgrSession::Application property

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

Obtains the application's GUID set by the inviter for this session from the registry.

This property is read/write.

Syntax

HRESULT put_Application(
  [in]          BSTR bstrAppGUID
);

HRESULT get_Application(
  [out, retval] BSTR *pbstrAppGUID
);

Property value

BSTR that specifies the application GUID. Maximum character length is 39 characters.

Remarks

The application's GUID format is {XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX} where X is a hexadecimal digit (0,1,2,3,4,5,6,7,8,9,A,B,C,D,E,F) and alphanumeric characters are in uppercase.

Setting bstrAppGUID to a GUID of an application not previously registered from a call to RegisterApplication will cause an error. This GUID must match one of the applications already registered.

The following table lists the error codes returned by this property.

Error Code	Meaning
E_INVALIDARG	The value passed into the property was not valid.
E_OUTOFMEMORY	The application ID value is too long.
SR_APP_NOT_SPECIFIED	The application was not specified.
SR_SESSION_NOT_READY	The session is not ready.

The following table lists the error codes returned by this method.

Error Code	Meaning
0x8007000E	The application ID value is too long.
0x80070057	The value passed into the property was not valid.
SR_SESSION_NOT_READY (0x81000605)	The session is not ready.
SR_APP_NOT_SPECIFIED (0x81000610)	The application was not specified.

Requirements

Minimum supported client	Windows XP [desktop apps only]
Minimum supported server	Windows Server 2003 [desktop apps only]
End of client support	Windows XP
End of server support	Windows Server 2003
Product	Messenger 4.0
Header	Msgrpriv.h
IDL	Msgrpriv.idl
DLL	Msgsc.dll

See also

IMsgrSession

RegisterApplication

Messenger Session Invite and Messenger Private APIs

Messenger Lock and Key API