Creates a new link between two entries in the keystore.
A link is an association between two entries in the keystore. The source of the link essentially points to the target of the link. Note, that deleting either the source or target entries out of the keystore will also automatically delete all links between those two entries.
- Parameters
-
pSourceUUID | [ in ] An identifier for the source of the link |
pTargetUUID | [ in ] An identifier for the target of the link |
pLinkType | [ in ] An application defined meaning for the link |
pMetaData | [ in ] (optional) data to be associated with the link (e.g., weight) |
pUUID | [ out ] Optional, can be NULL. Return the P6UUID associated with the link in the keystore. |
- Returns
Success | P6R::eOk | |
Failure | P6R::eInvalidArg | One of the parameters is NULL. |
P6R::eNotInitialized | A successful call to initialize was not made before this call. |
P6R::eInvalidState | A successful call to open() was not made before this call. |
P6R::eTooBig | pLinkType is larger than P6KSMAXLINKTYPE or pMetaData is larger than P6KSMAXLINKMETA. |
P6R::eTooSmall | pLinkType has length of zero. |
P6R::eNotFound | Objects identified by pSourceUUID or pTargetUUID do not exist in keystore. |