net.rim.device.api.crypto.certificate.status
Interface ProviderResponseData


public interface ProviderResponseData

Encapsulates information to be received on the device from the proxy during a certificate status response. Provider plugins on the device can access information sent from the corresponding plugin on the proxy from this interface.

See Also:
ProviderRequestData
Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
Since:
BlackBerry API 3.6.0

Method Summary
Category: Signed  byte[] getCertField(Certificate cert, int tag)
          Returns the field identified by the given tag, associated with the specified certificate.
Category: Signed  Enumeration getCertificates()
          Returns an enumeration containing all the certificates for which data exists in this response.
Category: Signed  Object getContextObject()
          Returns the context object set during the request encoding process.
Category: Signed  byte[] getGlobalField(int tag)
          Returns the value of the global field (for this response) associated with the given tag.
Category: Signed  void setCertificateStatus(Certificate cert, CertificateStatus status)
          Sets the status of the given certificate (to be sent later to the certificate status listener, and potentially used to update the Key Store).
 



Method Detail

getGlobalField

byte[] getGlobalField(int tag)
Returns the value of the global field (for this response) associated with the given tag.

Parameters:
tag - An integer value (in the range 0 to 255) associated with the data field in question.
Returns:
A byte array containing the data field.
Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
Since:
BlackBerry API 3.6.0

getCertificates

Enumeration getCertificates()
Returns an enumeration containing all the certificates for which data exists in this response. This should, but may not, be identical to the list of certificates sent to the proxy. It should not include any additional certificates.

Returns:
An enumeration of Certificates.
Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
Since:
BlackBerry API 3.6.0

getCertField

byte[] getCertField(Certificate cert,
                    int tag)
Returns the field identified by the given tag, associated with the specified certificate.

Parameters:
cert - The certificate associated with the field in question.
tag - An integer value (in the range 0 to 255) associated with the data field in question.
Returns:
A byte array containing the data field.
Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
Since:
BlackBerry API 3.6.0

getContextObject

Object getContextObject()
Returns the context object set during the request encoding process.

Returns:
The context object.
Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
Since:
BlackBerry API 3.6.0

setCertificateStatus

void setCertificateStatus(Certificate cert,
                          CertificateStatus status)
Sets the status of the given certificate (to be sent later to the certificate status listener, and potentially used to update the Key Store). This method MUST be called in order for the status of a given certificate to be set.

Parameters:
cert - The certificate of interest.
status - The status to assign to the certificate of interest.
Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
Since:
BlackBerry API 3.6.0





Copyright 1999-2011 Research In Motion Limited. 295 Phillip Street, Waterloo, Ontario, Canada, N2L 3W8. All Rights Reserved.
Java is a trademark of Oracle America Inc. in the US and other countries.
Legal