#use wml::openssl-macros area=docs page=X509_NAME_ENTRY_get_object

<title>Documents, X509_NAME_ENTRY_get_object(3)</title>

<h1>X509_NAME_ENTRY_get_object(3)</h1>

#use wml::imp::generic

{:
## What's this? [[s|(<STRONG>[^<].+?)</A>(</STRONG><DD>)|$1$2|sg]]
[[s|<P>\s+<P>|<P>|sg]]
[[s|<P>\s+</|</|sg]]
[[s|<DD>\s*<DT>|<DD>&nbsp;<DT>|sg]]
[[s|<DD>\s*</DL>|<DD>&nbsp;</DL>|sg]]
[[s|\[|&#91;|sg]]
[[s|\]|&#93;|sg]]

<!-- INDEX BEGIN -->

<UL>

	<LI><A HREF="#NAME">NAME</A>
	<LI><A HREF="#SYNOPSIS">SYNOPSIS</A>
	<LI><A HREF="#DESCRIPTION">DESCRIPTION</A>
	<LI><A HREF="#NOTES">NOTES</A>
	<LI><A HREF="#RETURN_VALUES">RETURN VALUES</A>
	<LI><A HREF="#SEE_ALSO">SEE ALSO</A>
	<LI><A HREF="#HISTORY">HISTORY</A>
</UL>
<!-- INDEX END -->

<HR>
<P>
<HR>
<H1><A NAME="NAME">NAME</A></H1>
<P>
X509_NAME_ENTRY_get_object, X509_NAME_ENTRY_get_data,
X509_NAME_ENTRY_set_object, X509_NAME_ENTRY_set_data,
X509_NAME_ENTRY_create_by_txt, X509_NAME_ENTRY_create_by_NID,
X509_NAME_ENTRY_create_by_OBJ - X509_NAME_ENTRY utility functions

</P>
<P>
<HR>
<H1><A NAME="SYNOPSIS">SYNOPSIS</A></H1>
<PRE> #include &lt;openssl/x509.h&gt;
</PRE>
<PRE> ASN1_OBJECT * X509_NAME_ENTRY_get_object(X509_NAME_ENTRY *ne);
 ASN1_STRING * X509_NAME_ENTRY_get_data(X509_NAME_ENTRY *ne);
</PRE>
<PRE> int X509_NAME_ENTRY_set_object(X509_NAME_ENTRY *ne, ASN1_OBJECT *obj);
 int X509_NAME_ENTRY_set_data(X509_NAME_ENTRY *ne, int type, const unsigned char *bytes, int len);
</PRE>
<PRE> X509_NAME_ENTRY *X509_NAME_ENTRY_create_by_txt(X509_NAME_ENTRY **ne, const char *field, int type, const unsigned char *bytes, int len);
 X509_NAME_ENTRY *X509_NAME_ENTRY_create_by_NID(X509_NAME_ENTRY **ne, int nid, int type,unsigned char *bytes, int len);
 X509_NAME_ENTRY *X509_NAME_ENTRY_create_by_OBJ(X509_NAME_ENTRY **ne, ASN1_OBJECT *obj, int type, const unsigned char *bytes, int len);
</PRE>
<P>
<HR>
<H1><A NAME="DESCRIPTION">DESCRIPTION</A></H1>
<P>
<CODE>X509_NAME_ENTRY_get_object()</CODE> retrieves the field name of <STRONG>ne</STRONG> in and <STRONG>ASN1_OBJECT</STRONG> structure.

</P>
<P>
<CODE>X509_NAME_ENTRY_get_data()</CODE> retrieves the field value of <STRONG>ne</STRONG> in and <STRONG>ASN1_STRING</STRONG> structure.

</P>
<P>
<CODE>X509_NAME_ENTRY_set_object()</CODE> sets the field name of <STRONG>ne</STRONG> to <STRONG>obj</STRONG>.

</P>
<P>
<CODE>X509_NAME_ENTRY_set_data()</CODE> sets the field value of <STRONG>ne</STRONG> to string type
<STRONG>type</STRONG> and value determined by <STRONG>bytes</STRONG> and <STRONG>len</STRONG>.

</P>
<P>
<CODE>X509_NAME_ENTRY_create_by_txt(),</CODE>
<CODE>X509_NAME_ENTRY_create_by_NID()</CODE> and
<CODE>X509_NAME_ENTRY_create_by_OBJ()</CODE> create and return an 
<STRONG>X509_NAME_ENTRY</STRONG> structure.

</P>
<P>
<HR>
<H1><A NAME="NOTES">NOTES</A></H1>
<P>
<CODE>X509_NAME_ENTRY_get_object()</CODE> and
<CODE>X509_NAME_ENTRY_get_data()</CODE> can be used to examine an <STRONG>X509_NAME_ENTRY</STRONG> function as returned by <CODE>X509_NAME_get_entry()</CODE> for example.

</P>
<P>
<CODE>X509_NAME_ENTRY_create_by_txt(),</CODE>
<CODE>X509_NAME_ENTRY_create_by_NID(),</CODE> and
<CODE>X509_NAME_ENTRY_create_by_OBJ()</CODE> create and return an 

</P>
<P>
<CODE>X509_NAME_ENTRY_create_by_txt(),</CODE>
<CODE>X509_NAME_ENTRY_create_by_OBJ(),</CODE>
<CODE>X509_NAME_ENTRY_create_by_NID()</CODE> and
<CODE>X509_NAME_ENTRY_set_data()</CODE> are seldom used in practice because <STRONG>X509_NAME_ENTRY</STRONG> structures are almost always part of <STRONG>X509_NAME</STRONG> structures and the corresponding <STRONG>X509_NAME</STRONG> functions are typically used to create and add new entries in a single
operation.

</P>
<P>
The arguments of these functions support similar options to the similarly
named ones of the corresponding <STRONG>X509_NAME</STRONG> functions such as <CODE>X509_NAME_add_entry_by_txt().</CODE> So for example <STRONG>type</STRONG> can be set to
<STRONG>MBSTRING_ASC</STRONG> but in the case of <CODE>X509_set_data()</CODE> the field name must be set
first so the relevant field information can be looked up internally.

</P>
<P>
<HR>
<H1><A NAME="RETURN_VALUES">RETURN VALUES</A></H1>
<P>
<HR>
<H1><A NAME="SEE_ALSO">SEE ALSO</A></H1>
<P>
<A HREF="../crypto/ERR_get_error.html#">ERR_get_error(3)</A>, <A HREF="../crypto/d2i_X509_NAME.html#">d2i_X509_NAME(3)</A>,
<EM>OBJ_nid2obj(3),OBJ_nid2obj(3)</EM>



</P>
<P>
<HR>
<H1><A NAME="HISTORY">HISTORY</A></H1>
<P>
TBA

</P>
:}