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