Discuss this help topic in SecureBlackbox Forum

TElSFTPServer.OnCreateSymLink

TElSFTPServer     See also     


Filter: C#  VB.NET  Pascal  C++  PHP  Java  


This event is fired when your software has to create a symbolic link.

Declaration

[C#]
    event TElSFTPServerCreateSymLinkEvent OnCreateSymLink;
    delegate void TElSFTPServerCreateSymLinkEvent(Object Sender, string LinkPath, string TargetPath, ref int ErrorCode, ref string Comment);

[VB.NET]
    Event OnCreateSymLink As TElSFTPServerCreateSymLinkEvent
    Delegate Sub TElSFTPServerCreateSymLinkEvent(ByVal Sender As Object, ByVal LinkPath As String, ByVal TargetPath As String, ByRef ErrorCode As Integer, ByRef Comment As String)

[Pascal]
    property OnCreateSymLink: TSBSFTPServerCreateSymLinkEvent;
    
    TSBSFTPServerCreateSymLinkEvent = procedure(Sender : TObject; const LinkPath : string; const TargetPath : string; var ErrorCode : integer; var Comment : string) of object;

[C++]
    void get_OnCreateSymLink(TElSFTPServerCreateSymLinkEvent &pMethodOutResult, void * &pDataOutResult);
    void set_OnCreateSymLink(TElSFTPServerCreateSymLinkEvent pMethodValue, void * pDataValue);
    typedef void (SB_CALLBACK *TElSFTPServerCreateSymLinkEvent)(void * _ObjectData, TObjectHandle Sender, const char * pcLinkPath, int32_t szLinkPath, const char * pcTargetPath, int32_t szTargetPath, int32_t &ErrorCode, char * pcComment, int32_t &szComment);

[PHP]
    TElSFTPServerCreateSymLinkEvent|callable|NULL get_OnCreateSymLink()
    void set_OnCreateSymLink(TElSFTPServerCreateSymLinkEvent|callable|NULL $Value)
    callable TElSFTPServerCreateSymLinkEvent(TObject $Sender, string $LinkPath, string $TargetPath, integer &$ErrorCode, string &$Comment)

[Java]
    TElSFTPServerCreateSymLinkEvent getOnCreateSymLink();
    void setOnCreateSymLink(TElSFTPServerCreateSymLinkEvent Value);
    TElSFTPServerCreateSymLinkEvent.Callback OnCreateSymLink = new TElSFTPServerCreateSymLinkEvent.Callback() {
        public void TElSFTPServerCreateSymLinkEventCallback(TObject Sender, String LinkPath, String TargetPath, TSBInteger ErrorCode, TSBString Comment) {
            //...
        }
    }

Parameters

  • LinkPath - specifies the name for a symbolic link to create
  • TargetPath - specifies the target of symbolic link
  • ErrorCode - the error code, see values below
  • Comment - server comment
  • pcLinkPath - specifies the name for a symbolic link to create
  • szLinkPath - the length of pcLinkPath.
  • pcTargetPath - specifies the target of symbolic link
  • szTargetPath - the length of pcTargetPath.
  • pcComment - server comment
  • szComment - the length of pcComment.

Error codes

SSH_ERROR_FILE_IS_A_DIRECTORY 24 (0x0018) The specified file was a directory in a context where a directory cannot be used
SSH_ERROR_BYTE_RANGE_LOCK_CONFLICT 25 (0x0019) A read or write operation failed because another process's mandatory byte-range lock overlaps with the request SSH_ERROR_BYTE_RANGE_LOCK_REFUSED 26 (0x001A) A request for a byte range lock was refused SSH_ERROR_DELETE_PENDING 27 (0x001B) An operation was attempted on a file for which a delete operation is pending SSH_ERROR_FILE_CORRUPT 28 (0x001C) The file is corrupt; an filesystem integrity check should be run SSH_ERROR_OWNER_INVALID 29 (0x001D) The principal specified can not be assigned as an owner of a file SSH_ERROR_GROUP_INVALID 30 (0x001E) The principal specified can not be assigned as the primary group of a file SSH_ERROR_UNSUPPORTED_VERSION 100 (0x0064) Sets of supported by client and server versions has no intersection SSH_ERROR_INVALID_PACKET 101 (0x0065) Invalid packet was received SSH_ERROR_TUNNEL_ERROR 102 (0x0066) Error is on the SSH-protocol level. The connection is closed because of SSH error SSH_ERROR_CONNECTION_CLOSED 103 (0x0067) Connection is closed SSH_ERROR_UNSUPPORTED_ACTION 104 (0x0068) … SSH_ERROR_NOT_A_TEXT_HANDLE 105 (0x0069) … SSH_ERROR_CANCELLED_BY_USER 106 (0x006A) … Declared in [.NET] [Pascal] [C++] Namespace: SBSftpCommon
Assembly: SecureBlackbox.SFTPCommon Unit: SBSftpCommon sbsftpcommon.h

Description

    This event is fired every time when new symbolic link has to be created. The application can return the error code in ErrorCode parameter and textual comment in Comment parameter.

See also:     OnCreateHardLink     OnReadSymLink     OnCreateDirectory     OnRemove    

Discuss this help topic in SecureBlackbox Forum