(Delphi DLL) SCP Upload Contents of String to Remote File

Demonstrates how to upload the contents of a string variable using the SCP protocol (Secure Copy Protocol over SSH). The text is uploaded to a file in specific remote directory. If the file did not already exist, it is created. If it already existed, it is overwritten.

Chilkat for Delphi Downloads Chilkat non-ActiveX DLL for Delphi Chilkat ActiveX DLL for Delphi * The examples here use the non-ActiveX DLL.

uses
    Winapi.Windows, Winapi.Messages, System.SysUtils, System.Variants, System.Classes, Vcl.Graphics,
    Vcl.Controls, Vcl.Forms, Vcl.Dialogs, Vcl.StdCtrls, Ssh, Scp;

...

procedure TForm1.Button1Click(Sender: TObject);
var
ssh: HCkSsh;
hostname: PWideChar;
port: Integer;
success: Boolean;
scp: HCkScp;
content: PWideChar;
remotePath: PWideChar;
charset: PWideChar;

begin
// This example requires the Chilkat API to have been previously unlocked.
// See Global Unlock Sample for sample code.

ssh := CkSsh_Create();

// Connect to an SSH server:

// Hostname may be an IP address or hostname:
hostname := 'www.some-ssh-server.com';
port := 22;

success := CkSsh_Connect(ssh,hostname,port);
if (success <> True) then
  begin
    Memo1.Lines.Add(CkSsh__lastErrorText(ssh));
    Exit;
  end;

// Wait a max of 5 seconds when reading responses..
CkSsh_putIdleTimeoutMs(ssh,5000);

// Authenticate using login/password:
success := CkSsh_AuthenticatePw(ssh,'myLogin','myPassword');
if (success <> True) then
  begin
    Memo1.Lines.Add(CkSsh__lastErrorText(ssh));
    Exit;
  end;

// Once the SSH object is connected and authenticated, we use it
// as the underlying transport in our SCP object.
scp := CkScp_Create();

success := CkScp_UseSsh(scp,ssh);
if (success <> True) then
  begin
    Memo1.Lines.Add(CkScp__lastErrorText(scp));
    Exit;
  end;

content := 'This string will be the contents of the remote file.';
remotePath := 'uploads/text/testUtf8.txt';

// The utf-8 byte representation of the string will be uploaded.
// See https://www.chilkatsoft.com/p/p_463.asp for a list of valid charsets.
charset := 'utf-8';

// This uploads to the "uploads/text" directory relative to the HOME
// directory of the SSH user account.  
// Note: The remote target directory must already exist on the SSH server.
success := CkScp_UploadString(scp,remotePath,content,charset);
if (success <> True) then
  begin
    Memo1.Lines.Add(CkScp__lastErrorText(scp));
    Exit;
  end;

remotePath := 'uploads/text/testUtf8_withBOM.txt';

// To include the utf-8 preamble (also known as the BOM),
// prefix the charset name with "bom:".  Any charset that can 
// optionally include a BOM can be specified in this way.
charset := 'bom:utf-8';

// Uploads to a remote file that contains text in the 
// utf-8 representation, including the BOM at the start of the file.
success := CkScp_UploadString(scp,remotePath,content,charset);
if (success <> True) then
  begin
    Memo1.Lines.Add(CkScp__lastErrorText(scp));
    Exit;
  end;

Memo1.Lines.Add('SCP upload string success.');

// Disconnect
CkSsh_Disconnect(ssh);

CkSsh_Dispose(ssh);
CkScp_Dispose(scp);

end;