Inside Macintosh: Open Transport /

Chapter 6 - Configuration Management / Configuration Management Reference

Functions / Creating, Cloning, and Removing a Configuration Structure

OTCloneConfiguration

Copies an OTConfiguration structure.

C INTERFACE

OTConfiguration* OTCloneConfiguration(OTConfiguration* cfig);

C++ INTERFACES

None. C++ applications use the C interface to this function.

PARAMETERS

cfig

A pointer to the OTConfiguration structure that you want
to copy.

DESCRIPTION

The OTCloneConfiguration function copies the OTConfiguration structure that you specify in the cfig parameter and returns a pointer to the copy. Because the internal format of an OTConfiguration structure is private, you must use the OTCloneConfiguration function to obtain two identical structures. For example, you can use this function when another application passes you a configuration structure that you want to reuse but for which you do not have the original configuration string. By cloning the structure, you have access to an additional copy of the configuration even without knowing its configuration string.

SEE ALSO

For more information about creating configuration structures, see the sections "About Provider Configurations" (page 6-3) and "Creating and Reusing Provider Configurations" (page 6-10).

To create an OTConfiguration structure, call the OTCreateConfiguration function (page 6-27).

To delete an OTConfiguration structure, call the OTDestroyConfiguration function (page 6-30).