Open topic with navigation

TIBCO Rendezvous® 8.7.0

# TibrvVcTransport::createConnectVc()

Method

## Declaration

    TibrvStatus createConnectVc(
        const char*        connectSubject,
        TibrvTransport*    transport);

## Purpose

Create a virtual circuit connect object.

## Remarks

This method creates a C connect transport and stores its handle in the C++ object.

Parameter | Description
`connectSubject` | The connect transport uses this connect subject to establish a virtual circuit with an accept transport in another program. The program must receive this connect subject from the accepting program. The call to TibrvVcTransport::createAcceptVc() creates this subject.
`transport` | The virtual circuit uses this ordinary transport for communications. Programs may use this transport for other purposes. It is illegal to supply a virtual circuit transport object for this parameter (that is, you cannot nest a virtual circuit within another virtual circuit).

## Test Before Using

Either of two conditions indicate that the connection is ready to use:

| • | The transport presents the `VC.CONNECTED` advisory.

| • | TibrvVcTransport::waitForVcConnection() returns without error.

Procedure

Immediately after this call, test both conditions with these two steps (in this order):

| 1. | Listen on the virtual circuit transport object for the `VC.CONNECTED` advisory.

| 2. | Call TibrvVcTransport::waitForVcConnection() with zero as the timeout parameter.

For an explanation, see Testing the New Connection in TIBCO Rendezvous Concepts.

## See Also

TibrvVcTransport::createAcceptVc()

TibrvVcTransport::waitForVcConnection()

VC.CONNECTED in TIBCO Rendezvous Concepts

VC.DISCONNECTED in TIBCO Rendezvous Concepts

Did you find this helpful?

Yes No
Great!
Thanks for taking the time to give us some feedback.
Sorry about that

Why wasn't this helpful? (check all that apply)

Could not find what I was looking for
Instructions confusing or unclear
Instructions did not work

Want to tell us more?

Please select at least one option or provide details about the issue!!

Error occurred while submitting feedback.

Error2 occurred while submitting feedback.

TIBCO Rendezvous®

Copyright © 1997-2023. Cloud Software Group, Inc. All Rights Reserved.