ConnectAndExec Method

Connects to an SSH server and executes a command in one go.

Syntax

• C++
• Objective-C
• C

ANSI (Cross Platform)
char* ConnectAndExec(const char* lpszAddress, int iPort, const char* lpszCommand, int bWantStdout, int bWantStdErr, int *lpSize = NULL);

Unicode (Windows)
LPSTR ConnectAndExec(LPCWSTR lpszAddress, INT iPort, LPCWSTR lpszCommand, BOOL bWantStdout, BOOL bWantStdErr, LPINT lpSize = NULL);

- (NSData*)connectAndExec:(NSString*)address :(int)port :(NSString*)command :(BOOL)wantStdout :(BOOL)wantStdErr;

#define MID_SSHCLIENT_CONNECTANDEXEC 4

SECUREBLACKBOX_EXTERNAL int SECUREBLACKBOX_CALL SecureBlackbox_SSHClient_Do(void *lpObj, int methid, int cparam, void *param[], int cbparam[], int64 *lpllVal);

Remarks

Use this method to connect to an SSH server at Address and Port and execute a command. The method returns the output of the executed command.

This method is a handy shortcut for running non-interactive commands. It encapsulates calls to Connect, Receive, Disconnect internally to save you time and space.

Please note that ConnectAndExec always runs synchronously, thus ignoring the AsyncMode setting.

Error Handling (C++)

This method returns a Byte Array value (with length lpSize); after it returns, call the GetLastErrorCode() method to obtain its 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.