função CertStore_GetCertificateIdentifierAt

Cabeçalho: #include <applibs/certstore.h>

Obtém o ID do certificado no índice especificado.

int CertStore_GetCertificateIdentifierAt(size_t index, CertStore_Identifier *outIdentifier);

Parâmetros

• index O índice do certificado. Os valores de índice variam entre 0 o número total de certificados no dispositivo.

• outIdentifier Um ponteiro para a estrutura CertStore_Identifier que recebe o ID do certificado.

Erros

Devolve -1 se for encontrado um erro e define errno para o valor de erro.

• EACCES: a operação não é permitida porque a capacidade CertStore não está definida no manifesto da aplicação.

• EAGAIN: o componente certstore do SO ainda não está pronto.

• EFAULT: o outIdentifier parâmetro é NULL.

• ENOENT: não existe nenhum certificado no índice especificado.

• ERANGE: o index não está no intervalo válido.

Qualquer outro errno também pode ser especificado; tais erros não são deterministas e não há garantias de que o mesmo comportamento será mantido através de atualizações do sistema.

Valor devolvido

Devolve 0 para êxito ou -1 para falha, caso errno em que está definido como o valor de erro.

Requisitos do manifesto de aplicação

O manifesto da aplicação tem de incluir a capacidade CertStore.