Query: rapi_connection_from_name
OS: debian
Section: 3
Format: Original Unix Latex Style Formatted with HTML and a Horizontal Scroll Bar
RAPI_CONNECTION_FROM_NAME(3) http://www.synce.org/ RAPI_CONNECTION_FROM_NAME(3)NAMErapi_connection_from_name - obtain connection for RAPI function callsSYNOPSIS#include <rapi.h> RapiConnection *rapi_connection_from_name(const char *device_name); RapiConnection *rapi_connection_from_info(SynceInfo *info); void rapi_connection_select(RapiConnection *connection); void rapi_connection_destroy(RapiConnection *connection); HRESULT CeRapiInit(); STDAPI CeRapiUninit();DESCRIPTIONThe rapi_connection_from_info() function returns a pointer to a newly allocated RapiConnection struct, used for remote function calls to a mobile device. The RapiConnection keeps a pointer to the SynceInfo struct but does not copy it, therefore freeing the SynceInfo before the RapiConnection is not recommended. rapi_connection_from_name() accomplishes the same for the connected device named device_name. Refer to synce_info_new(3) for insight on how this name and the connection daemon in use can affect the device contacted. rapi_connection_select() allows for selection between multiple active connections. NULL can be passed to result in no active connection. rapi_connection_destroy() frees a RapiConnection. This should not be called before CeRapiUninit(). CeRapiInit() connects the current RapiConnection to it's mobile device. If already initialised, CERAPI_E_ALREADYINITIALIZED is returned. CeRapiUninit() destroys the connection for the current RapiConnection. The RapiConnection cannot be re-initialised, it must be destroyed. An example of using multiple devices follows. /* * SynCE support for switching between multiple devices * * Example code for two devices follows! * * It shows two different ways to get a RapiConnection object. * */ RapiConnection* a = rapi_connection_from_name("device_a"); rapi_connection_select(a); CeRapiInit() SynceInfo* info_b = synce_info_new("device_b"); RapiConnection* b = rapi_connection_from_info(info_b); rapi_connection_select(b); CeRapiInit() rapi_connection_select(a); ...some RAPI calls to device A... rapi_connection_select(b); ...some RAPI calls to device B... rapi_connection_select(a); CeRapiUninit(); rapi_connection_destroy(a); rapi_connection_select(b); CeRapiUninit(); rapi_connection_destroy(b); synce_info_destroy(info_b);RETURN VALUErapi_connection_from_name() and rapi_connection_from_info() return a pointer to a new RapiConnection. CeRapiInit() and CeRapiUninit() return S_OK on success or an error code on failure.AUTHORThis manual page was written by Mark Ellis <mark_ellis@users.sourceforge.net>.SEE ALSOsynce(7), synce_info_new(3), odccm(1), vdccm(1) The SynCE Project 2007-08-26 RAPI_CONNECTION_FROM_NAME(3)
Related Man Pages |
---|
synce-pcp(1) - debian |
rapi_connection_from_name(3) - debian |
roar_vs_new_from_con(3) - debian |
xchangepointerdevice(3x11) - osf1 |
synce(7) - sunos |
Similar Topics in the Unix Linux Community |
---|
Skin for PDA |
SynCE: vdccm 0.10.1 released |
launch2net 1.0.8 (Default branch) |
Multiple wan connection on single PC |
Starting New Discussions Temporarily Disabled on Mobile |