C
C
Write Bytes to a Remote SFTP File (BinData)
See more SFTP Examples
Demonstrates the Chilkat SFtp.WriteFileBd method, which appends all bytes in a BinData to the remote file identified by an open handle. The first argument is the handle and the second is the BinData.
Note: This example uses a relative local path, which is resolved against the application's current working directory. Absolute local paths may also be used. Supply the path appropriate to your own environment.
Background: This is the binary counterpart to
WriteFileText — the right choice for images, archives, or any non-text content, where a charset conversion would corrupt the data. Combined with an appropriate OpenFile disposition it can create, overwrite, or append; here the file is created/truncated first so the result is exactly the BinData contents.Chilkat C Downloads
#include <C_CkSFtp.h>
#include <C_CkBinData.h>
void ChilkatSample(void)
{
BOOL success;
HCkSFtp sftp;
int port;
const char *password;
const char *handle;
HCkBinData bd;
success = FALSE;
// Demonstrates the SFtp.WriteFileBd method, which appends all bytes in a BinData to the remote
// file identified by an open handle. The 1st argument is the handle and the 2nd is the BinData.
sftp = CkSFtp_Create();
// Connect, authenticate, and initialize the SFTP subsystem.
port = 22;
success = CkSFtp_Connect(sftp,"sftp.example.com",port);
if (success == FALSE) {
printf("%s\n",CkSFtp_lastErrorText(sftp));
CkSFtp_Dispose(sftp);
return;
}
// Normally you would not hard-code the password in source. You should instead obtain it
// from an interactive prompt, environment variable, or a secrets vault.
password = "mySshPassword";
success = CkSFtp_AuthenticatePw(sftp,"mySshLogin",password);
if (success == FALSE) {
printf("%s\n",CkSFtp_lastErrorText(sftp));
CkSFtp_Dispose(sftp);
return;
}
success = CkSFtp_InitializeSftp(sftp);
if (success == FALSE) {
printf("%s\n",CkSFtp_lastErrorText(sftp));
CkSFtp_Dispose(sftp);
return;
}
// Open (creating/truncating) the remote file for writing.
handle = CkSFtp_openFile(sftp,"subdir/image.png","writeOnly","createTruncate");
if (CkSFtp_getLastMethodSuccess(sftp) == FALSE) {
printf("%s\n",CkSFtp_lastErrorText(sftp));
CkSFtp_Dispose(sftp);
return;
}
// Put the bytes to write into a BinData. (Here they are loaded from a local file, but the
// bytes could come from anywhere.)
bd = CkBinData_Create();
success = CkBinData_LoadFile(bd,"qa_data/image.png");
if (success == FALSE) {
printf("%s\n",CkBinData_lastErrorText(bd));
CkSFtp_Dispose(sftp);
CkBinData_Dispose(bd);
return;
}
// Append the BinData bytes to the open remote file.
success = CkSFtp_WriteFileBd(sftp,handle,bd);
if (success == FALSE) {
printf("%s\n",CkSFtp_lastErrorText(sftp));
CkSFtp_Dispose(sftp);
CkBinData_Dispose(bd);
return;
}
success = CkSFtp_CloseHandle(sftp,handle);
if (success == FALSE) {
printf("%s\n",CkSFtp_lastErrorText(sftp));
CkSFtp_Dispose(sftp);
CkBinData_Dispose(bd);
return;
}
printf("Wrote %d bytes.\n",CkBinData_getNumBytes(bd));
CkSFtp_Disconnect(sftp);
CkSFtp_Dispose(sftp);
CkBinData_Dispose(bd);
}