blob: f27b77d0e1736239fbf534f0b9c4e11b45d32e6d (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
|
/*
* Jitsi, the OpenSource Java VoIP and Instant Messaging client.
*
* Copyright @ 2015 Atlassian Pty Ltd
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package net.java.sip.communicator.plugin.addrbook.msoutlook;
/**
* Represents a specific Microsoft Outlook MAPI <tt>HRESULT</tt> as an
* <tt>Exception</tt>.
*
* @author Lyubomir Marinov
*/
public class MsOutlookMAPIHResultException
extends Exception
{
/**
* Serial version UID.
*/
private static final long serialVersionUID = 0L;
/**
* The <tt>HRESULT</tt> which is represented by this <tt>Exception</tt>.
*/
private final long hResult;
/**
* Initializes a new <tt>MsOutlookMAPIHResultException</tt> instance which
* is to represent a specific <tt>HRESULT</tt>.
*
* @param hResult the <tt>HRESULT</tt> to be represented by the new instance
*/
public MsOutlookMAPIHResultException(long hResult)
{
this(hResult, toString(hResult));
}
/**
* Initializes a new <tt>MsOutlookMAPIHResultException</tt> instance which
* is to represent a specific <tt>HRESULT</tt> and to provide a specific
* <tt>String</tt> message.
*
* @param hResult the <tt>HRESULT</tt> to be represented by the new instance
* @param message the <tt>String</tt> message to be provided by the new
* instance
*/
public MsOutlookMAPIHResultException(long hResult, String message)
{
super(message);
this.hResult = hResult;
}
/**
* Initializes a new <tt>MsOutlookMAPIHResultException</tt> instance with a
* specific <tt>String</tt> message.
*
* @param message the <tt>String</tt> message to be provided by the new
* instance
*/
public MsOutlookMAPIHResultException(String message)
{
this(0, message);
}
/**
* Gets the <tt>HRESULT</tt> which is represented by this
* <tt>Exception</tt>.
*
* @return the <tt>HRESULT</tt> which is represented by this
* <tt>Exception</tt>
*/
public long getHResult()
{
return hResult;
}
/**
* Converts a specific <tt>HRESULT</tt> to a touch more readable
* <tt>String</tt> in accord with the rule of constructing MAPI
* <tt>HRESULT</tt> values.
*
* @param hResult the <tt>HRESULT</tt> to convert
* @return a <tt>String</tt> which represents the specified <tt>hResult</tt>
* in a touch more readable form
*/
private static String toString(long hResult)
{
if (hResult == 0)
return "S_OK";
else
{
StringBuilder s = new StringBuilder("MAPI_");
s.append(((hResult & 0x80000000L) == 0) ? 'W' : 'E');
s.append("_0x");
s.append(Long.toHexString(hResult & 0xFFFL));
s.append(" (" + Long.toHexString(hResult) + ")");
return s.toString();
}
}
/**
* Returns the string representation for the current hResult code.
*
* @return The string representation for the current hResult code.
*/
public String getHresultString()
{
return MsOutlookMAPIHResultException.toString(this.getHResult());
}
}
|
