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 |
|
| IDL |
|
| DLL |
|