NAME
X509_ATTRIBUTE_get0_object,
X509_ATTRIBUTE_count,
X509_ATTRIBUTE_get0_type,
X509_ATTRIBUTE_get0_data —
X.501 Attribute read
accessors
SYNOPSIS
#include
<openssl/x509.h>
ASN1_OBJECT *
X509_ATTRIBUTE_get0_object(X509_ATTRIBUTE
*attr);
int
X509_ATTRIBUTE_count(const
X509_ATTRIBUTE *attr);
ASN1_TYPE *
X509_ATTRIBUTE_get0_type(X509_ATTRIBUTE
*attr, int index);
void *
X509_ATTRIBUTE_get0_data(X509_ATTRIBUTE
*attr, int index, int
type, void *data);
DESCRIPTION
These functions provide read access to the X.501 Attribute object attr.
For
X509_ATTRIBUTE_get0_data(),
the type argument usually is one of the
V_ASN1_* constants defined in
<openssl/asn1.h>. For
example, if a return value of the type
ASN1_OCTET_STRING is expected, pass
V_ASN1_OCTET_STRING as the
type argument. The data argument
is ignored; passing NULL is recommended.
RETURN VALUES
X509_ATTRIBUTE_get0_object() returns an
internal pointer to the type of attr or
NULL if attr is
NULL or if its type is not set.
X509_ATTRIBUTE_count() returns the number
of values stored in attr or 0 if no value or values
are set.
X509_ATTRIBUTE_get0_type() returns an
internal pointer to the ASN.1 ANY object representing the value with the
given zero-based index or NULL
if attr is NULL, if the
index is larger than or equal to the number of values
stored in attr, or if no value or values are set.
X509_ATTRIBUTE_get0_data() returns an
internal pointer to the data contained in the value with the given
zero-based index or NULL if
attr is NULL, if the
index is larger than or equal to the number of values
stored in attr, if no value or values are set, or if
the ASN.1 ANY object representing the value with the given
index is not of the requested
type.
SEE ALSO
ASN1_OBJECT_new(3), ASN1_TYPE_new(3), OPENSSL_sk_new(3), X509_ATTRIBUTE_new(3), X509_ATTRIBUTE_set1_object(3)
HISTORY
These functions first appeared in OpenSSL 0.9.5 and have been available since OpenBSD 2.7.