AdsDDCreatePublication

Advantage Client Engine

Add a new publication to the data dictionary.

Syntax

UNSIGNED32 ENTRYPOINT AdsDDCreatePublication( ADSHANDLE hDictionary,

UNSIGNED8 *pucPublicationName,

UNSIGNED8 *pucComments,

UNSIGNED32 ulOptions );

 

Parameters

hDictionary (I)

A data dictionary connection.

pucPublicationName (I)

The name of the publication to be created.

pucComments (I)

Optional description of the publication.

ulOptions (I)

This is reserved for future use. It should be ADS_DEFAULT (0).

Remarks

This function creates a new publication object for holding replication articles. The publication itself is just a container object and has no specific properties associated with it. See Replication for more details.

Note This function can be called inside a transaction, but will not be part of the transaction. Any changes it makes cannot be rolled back.

Example

ulRetVal = AdsDDCreatePublication( hConn, "mypub", "test publication",

ADS_DEFAULT );

ulRetVal = AdsDDCreateArticle( hConn, "mypub", "table1", NULL, NULL,

     ADS_IDENTIFY_BY_ALL );

ulRetVal = AdsDDCreateSubscription( hConn, "mysub", "mypub",

"\\\\server\\share\\path\\target.add",

"username", "password", "repqueue.adt", FALSE,

"test subscription",

ADS_SUBSCR_IGNORE_FAILED_REP |

ADS_SUBSCR_LOG_FAILED_REP_DATA );

 

See Also

AdsDDGetPublicationProperty

AdsDDSetPublicationProperty

AdsDDDeletePublication

AdsDDCreateArticle

AdsDDCreateSubscription