Previous section.

Common Security: CDSA and CSSM
Copyright © 1997 The Open Group

NAME

ISL_FindSignatureAttribute

SYNOPSIS

ISL_STATUS ISL_FindSignatureAttribute
    (ISL_VERIFIED_SIGNATURE_ROOT_PTR Root,
    ISL_CONST_DATA Name,
    ISL_CONST_DATA_PTR Value)

DESCRIPTION

This function returns the value associated with the signature attribute specified by Name. The value and its length are returned in the Value pointer. The function returns ISL_FAIL if the specified attribute does not exist.

PARAMETERS

Root (input)

A verified signature root explicitly created by ISL_CreateVerifiedSignatureRoot or ISL_CreateVerifiedSignatureRootWithCertificate, or implicitly by ISL_SelfCheck, ISL_VerifyAndLoadModuleAndCredentials, or ISL_VerifyLoadedModuleAndCredentials.

Name (input)

The name of the attribute that is requested. The representation of the attribute name must be consistent with the representation of certificates. For example, attribute names for signatures associated with X.509V3 certificates would be DER-encoded object identifiers.

Value (input/output)

The data pointer and length are updated to point to a read-only copy of the attribute.

RETURN VALUE

ISL_OK is returned if the attribute is found, otherwise ISL_FAIL.

SEE ALSO

ISL_CreateVerifiedSignatureRoot,
ISL_CreateVerifiedSignatureRootWithCertificate,
ISL_SelfCheck,
ISL_VerifyAndLoadModuleAndCredentials,
ISL_VerifyLoadedModuleAndCredentials,
ISL_GetModuleManifestSection,
ISL_GetManifestSignatureRoot

Why not acquire a nicely bound hard copy?
Click here to return to the publication details or order a copy of this publication.
You should also read the legal notice explaining the terms and conditions relating to the CDSA documentation.

Contents Next section Index