Carbon


KCAttribute

Header: Keychain.h

Contains information about a keychain item attribute.

struct KCAttribute {
    KCAttrType tag; 
    UInt32 length; 
    void *data;
};
typedef KCAttribute KCAttributePtr;

Field descriptions

tag

Identifies a keychain item attribute value. See “Keychain Item Data Tag Constants” for a description of the Apple-defined tag constants and the data types of the values they identify. Your application can create application-defined tags of type KCAttrType.

length

The length of the attribute data.

data

A pointer to the attribute data. When calling the function KCSetAttribute, you should set this field to a pointer to the attribute data you wish to add. When calling the function KCGetAttribute, you should set this field to a pointer to a buffer of sufficient length for the type of data to be returned. On return, this field contains the requested attribute data.

The KCAttribute type represents a structure containing information about the attribute of a keychain item. It contains a tag that identifies a particular keychain item attribute value, the length of the attribute value, and a pointer to the attribute value. You can modify attribute data for a keychain item attribute by passing a pointer to this structure in the attr parameter of the function KCSetAttribute. The function KCGetAttribute passes back a pointer to this structure in the attr parameter.


© 2000 Apple Computer, Inc. (Last Updated 7/17/2000)