Finds and returns a certificate chain associated with an existing key.
The pNamespace and pName parameters are associated with the key the chain belongs to.
- Parameters
-
pNamespace | [ in ] An identifier to separate the namespace of pName between applications |
pName | [ in ] An application defined, unique identifier for a key |
pCertChain | [ out ] An array of certificates that represent a keys certificate chain. If NULL, then the number of certificates in the chain is returned in the parameter pNumWritten. |
numChain | [ in ] The number of entires in the pCertChain array |
pNumWritten | [ out ] The number of certificates written into pCertChain, or if pCertChain is NULL, the number required. |
- Returns
Success | P6R::eOk | |
Failure | P6R::eInvalidArg | One of the parameters is NULL (except for pCertChain). |
P6R::eNotInitialized | A successful call to initialize was not made before this call. |
P6R::eNotFound | There is no keystore entry associated with the pNamespace pName identifer. |
P6R::eFail | The number of entries in pCertChain are too small to hold the entire chain. |
P6R::eInvalidState | A successful call to open() was not made before this call. |
P6R::eTooBig | pNamespace is larger than P6KSMAXNAMESPACE or pName is larger than P6KSMAXNAME. |
P6R::eTooSmall | pNamespace or pName have length of zero. |