SEDRIS Reference Manual
APPENDIX A - Transmittal Access Level 0 API
Functions
SE GetUnresolvedObjectFromPublishedLabel
extern SE_Return_Code
SE_GetUnresolvedObjectFromPublishedLabel
(
constSE_URN *transmittal_name,1
constSE_String *object_label,2
SE_Encoding encoding,3
SE_Object *object4
);

Definition

This function creates an unresolved reference to a DRM object based on the combination of transmittal_name and object_label as supported in the specified encoding.

This function does not validate the reference to ensure that it can be resolved. This behavior is intentional in order to allow referencing well known published DRM objects, without requiring the transmittal containing the DRM object to be accessible. Care must be taken to ensure the reference is indeed correct. The SE_ResolveObject() function is available to do this, but requires that the referenced transmittal be accessible.


Returns

SE_RETCOD_SUCCESS and the object is returned.
SE_RETCOD_FAILURE and the status code is set appropriately if the call failed.

Status Codes

SE_Status_Code(s) when SE_RETCOD_SUCCESS is returned:

SE_STATCODE_SUCCESS set if valid parameters were specified and all operations succeeded.

SE_Status_Code(s) when SE_RETCOD_FAILURE is returned:

SE_STATCODE_INVALID_TRANSMITTAL_NAME set if the transmittal URN was not valid according to the SEDRIS URN syntax rules.
SE_STATCODE_INVALID_OBJECT_LABEL set if object_label was not valid according to the label syntax rules.
SE_STATCODE_INACTIONABLE_FAILURE set if the call fails for any reason.


Parameters Notes

1 the fully qualified URN of the transmittal that contains the labeled object.

2 the label under which the object was published.

3 identifies the API implementation encoding to use when retrieving these objects. If the specified API can't find the objects, then the API will return a status code indicating why they could not be found. See also SE_GetEncoding().

4 a pointer to an SE_Object variable from the user, in which the object handle will be stored.


Prev: SE_GetUniqueTransmittalID. Next: SE_GetUserData. Up:Index.

Last updated: July 26, 2006 Copyright © 2006 SEDRIS