CreateTrustedAppObject

Syntax

#include <gwtapp.h>

INT WINAPI CreateTrustedAppObject(
     char       *szDomainPath,          
     char       *szAppName,
     char       *szAppDesc,
     char       *szTCPAddress,    
     WORD        uwTCPPort,
     BOOL        bSSLRequired,            
     BOOL        bRequiresQueueing,
     BOOL        bMessageRetention,
     BOOL        bOverwrite,
     char       *szTrustedAppKey);

Parameters

szDomainPath

(IN) Points to an ASCII path to the primary domain. Maximum length: 260 bytes.

szAppName

(IN) Points to the name of the trusted application. The application names must be unique when the application is installed more than once.

szAppDesc

(IN) Points to a description of the trusted application for display in ConsoleOne or other utility (optional).

szTCPAddress

(IN) Points to the IP Address of the of the machine where the trusted application can be run (optional). The IP address can be in DNS or dotted format.

uwTCPPort

(IN) Specifies IP Port of the machine where the trusted application can be run (optional).

bSSLRequired

(IN) Specifies TRUE or FALSE to indicate the trusted application connection requires SSL.

bRequiresQueueing

(IN) Is currently not implemented.

bMessageRetention

(IN) Specifies TRUE or FALSE to indicate whether the trusted application provides message retention services.

bOverwrite

(IN) Specifies true or false to indicate the trusted application should overwrite a trusted application record with the same application name.

szTrustedAppKey

(OUT) Points to the unique access key assigned to the trusted application. Returns a 64 byte key plus null.

Return Values