Connect Method

Attempts to dial the PhonebookEntry from Phonebook .

Syntax

ANSI (Cross Platform)
int Connect();

Unicode (Windows)
INT Connect();
- (void)connect;
#define MID_NETDIAL_CONNECT 3

IPWORKS_EXTERNAL int IPWORKS_CALL IPWorks_NetDial_Do(void *lpObj, int methid, int cparam, void *param[], int cbparam[], int64 *lpllVal);

Remarks

This method attempts to dial the PhonebookEntry from Phonebook. If that is empty then the PhoneNumber, CallbackNumber, and Domain (if applicable) are used to connect. The class doesn't return until the operation is completed, but during this time Status events are fired showing the ongoing progress.

Example (Dialing a Phonebook)


NetDialControl.Phonebook = "MyPhonebook"
NetDialControl.Connect()

Example (Direct Dialing a Phone Number)


NetDialControl.PhoneNumber = "MyPhonebook"
NetDialControl.User = "username"
NetDialControl.Password = "mypassword"
NetDialControl.Connect()

NOTE: Direct Dialing is not supported on Pocket PC (Windows CE).

Error Handling (C++)

This method returns a result code; 0 indicates success, while a non-zero error code indicates that this method encountered an error during its execution. If an error occurs, the GetLastError() method can be called to retrieve the associated error message. (Note: This method's result code can also be obtained by calling the GetLastErrorCode() method after it returns.)

Copyright (c) 2022 /n software inc. - All rights reserved.
IPWorks 2020 C++ Edition - Version 20.0 [Build 8307]