PK_ATTRIB_ask_named_ustring

PK_ERROR_code_t    PK_ATTRIB_ask_named_ustring
(
--- received arguments ---
PK_ATTRIB_t        attrib,      --- attribute
const char        *field_name,  --- field name

--- returned arguments ---
PK_UCHAR_t **const string       --- pointer to Unicode string
                                --- (possibly NULL)
)


This function returns the Unicode string stored in field 'field_name'
of the given attribute.


Specific Errors:
    PK_ERROR_bad_name               The attribute does not have a field with
                                    this name
    PK_ERROR_field_of_wrong_type    The field is not a Unicode field


If field number 'field_name' is a Unicode string field containing no
characters, then the character string is set to NULL.

See Attribute processing for more information.

See Using named fields for information using named attributes.