Developer's Guide
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Macros Groups Pages
virtual P6R::P6ERR P6R::p6ICert::getDistinguishedName ( P6WCHAR pBuffer,
P6SIZE  cBuffer,
P6SIZE pcWritten 
)
pure virtual

Extract an RFC 2253 compatible representation of the Subject name of the certificate.

Note, that the pWritten parameter can be set to NULL if the caller is not interested in the number of bytes written into the buffer. However, this parameter is also used to return the bytes required to copy the key into when pBuffer is set to NULL.

Parameters
pBuffer[ in ] Block of memory to write the certificate into, when NULL the required size of this buffer is returned in pcBytesWritten
cBuffer[ in ] Number of entries in the buffer pointed to by pBuffer.
pcWritten[ out ] Optional can be NULL, returns the number of characters written into pString. This parameter cannot be NULL when pString is also NULL.
Returns
SuccessP6R::eOk 
FailureP6R::eInvalidArgpBuffer and pcBytesWritten cannot both be NULL.
P6R::eTooSmallpBuffer is too small to copy the key into.
P6R::eFailAn error occurred trying to write the certificate into the pBuffer.
P6R::eNoMemoryrInsufficient available memory to copy the certificate into pBuffer.