Allows certificate status providers to display UI to the user (while
processing status requests or responses) in a uniform fashion.
Category:
CryptoExtensionAPI: This element is part of the Crypto Extension API. These APIs are intended for parties interested in extending the security provider frameworks, such as integrating a new security medium.
Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.
Since:
JDE 3.6.0
Field Summary
static int
NO_UI_AVAILABLE
Indicates that no UI is currently available.
Method Summary
int
promptUser(String title,
String message,
String[] buttonText,
int[] returnCodes)
Prompts the user with a dialog containing the specified title, message, and
buttons.
Indicates that no UI is currently available. Either the request was cancelled,
or the request was started as non-UI. This value is -1.
Since:
JDE 3.6.0
Category:
CryptoExtensionAPI: This element is part of the Crypto Extension API. These APIs are intended for parties interested in extending the security provider frameworks, such as integrating a new security medium.
Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.
Method Detail
promptUser
public int promptUser(String title,
String message,
String[] buttonText,
int[] returnCodes)
Prompts the user with a dialog containing the specified title, message, and
buttons. A button is created for each entry in the buttonText array.
This method blocks until the user chooses one of the buttons in the dialog. The return
value is the return code associated with the specified button, as determined by the
returnCodes array. If no UI is available to the provider for some reason,
the method returns immediately with NO_UI_AVAILABLE.
Parameters:
title - A title to be shown at the top of the dialog.
message - A textual message to be shown to the user.
buttonText - An array of strings specifying the labels of the buttons that
should be placed at the bottom of the dialog. One button is created for each string.
returnCodes - An array of integers storing the return codes for each button in
buttonText.
Returns:
The return code of the button that was selected, or NO_UI_AVAILABLE
if UI cannot presently be shown to the user.
Since:
JDE 3.6.0
Category:
CryptoExtensionAPI: This element is part of the Crypto Extension API. These APIs are intended for parties interested in extending the security provider frameworks, such as integrating a new security medium.
Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.
Sets the error message for the current provider. This method should be called in the
case of an error to specify an error message that can be shown to the user. The
message may or may not be shown to the user depending on how the status request was
initiated (UI or non-UI) and the current state of the status popup dialog.
Parameters:
message - A (descriptive) textual error message that can be shown to the user.
Since:
JDE 3.6.0
Category:
CryptoExtensionAPI: This element is part of the Crypto Extension API. These APIs are intended for parties interested in extending the security provider frameworks, such as integrating a new security medium.
Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.
Copyright 1999-2007 Research In Motion Limited. 295 Phillip Street, Waterloo, Ontario, Canada, N2L 3W8. All Rights Reserved. Copyright 1993-2003 Sun Microsystems, Inc. 901 San Antonio Road, Palo Alto, California, 94303, U.S.A. Copyright 2002-2003 Nokia Corporation All Rights Reserved. Java is a trademark or registered trademark of Sun Microsystems, Inc. in the US and other countries.