Function CDM_SetOwner


Definition:#include <CDM.h>
Prototype:char * CDM_SetOwner(CDM_Collection Collection, char *Owner);
Arguments:

Collection: A Collection object. (CDM_Collection)
Owner: The desired new Owner of the Collection. (char *)

C/C++ API Sections
Tcl API Sections
Description
Return Value
Notes
See Also
Index

Description:

This function will change the Owner of the specified Collection. The value of the "Owner" parameter will not modified in any way by CDM, as a local copy will be created and modified internally by the CDM.

Return Value:

This function will return a pointer (of type char*) to the string buffer that holds the new Collection Owner. This pointer will be at a different memory location than the given parameter value, as the CDM will create and manipulate a local copy.

In case of an error, NULL will be returned and an error message describing the error will be left at the current Tcl interpreter (CDM_Interp).

Note that the returned pointer is property of the CDM and should never be freed or modified in any way by the caller.

Notes:

This function is equivelant to tip_SetOwner (Tcl API).

See Also:

tip_SetOwner


Generated by: petasis@aias on Wed Aug 16 10:31:57 PM EEST 2006.