From WikiChip
Difference between revisions of "mirc/on events/on getfail"
< mirc‎ | on events

(Created On getfail event - mIRC)
 
m (→‎See also: fix dead link)
 
(11 intermediate revisions by 3 users not shown)
Line 1: Line 1:
−
The '''ON GETFAIL''' event triggers whenever a remote user sends a file via [[Dcc - mIRC|DCC]] and it fails.
+
{{mirc title|On Getfail - Events}}
−
 
+
The '''ON GETFAIL''' event triggers whenever a remote user sends a file via {{mIRC|/dcc|DCC send}} and it fails.
−
This event fills [[$filename identifier - mIRC|$filename]], [[$address identifier - mIRC|$address]], and [[$nick identifier - mIRC|$nick]] with the filename, user's address, and the user's nickname (if available), respectively.
 
  
 
== Synopsis ==
 
== Synopsis ==
Line 7: Line 6:
  
 
== Parameters ==
 
== Parameters ==
−
<span style="display: inline-block; width: 155px;">'''<level>'''</span>The level for the event to trigger.
+
* '''<level>''' - The corresponding {{mIRC|access levels}} for the event to trigger.
  
−
<span style="display: inline-block; width: 155px;">'''<filename[,filename]>'''</span>The filename(s) that should match the failed file. These can be [[wildcard|wildcards]]. Example: ''*.txt,*.doc,my*.txt''
+
* '''<filename>''' - The filename(s) that should match the received file. Seperate multiple values by commas. These can be {{mIRC|wildcard|wildcards}}. Example: ''*.txt,*.doc,my*.txt''
  
−
<span style="display: inline-block; width: 155px;">'''<commands>'''</span>The commands to be performed when the event listener's criteria is met.
+
* '''<commands>''' - The commands to be performed when the event listener's criteria is met.
 +
 
 +
== {{mIRC|local identifiers}} ==
 +
 
 +
=== {{mIRC|$filename}} ===
 +
 
 +
Returns the complete filename of the received file.
  
 
== Examples ==
 
== Examples ==
Line 18: Line 23:
  
 
== Compatibility ==
 
== Compatibility ==
−
Added: mIRC v5.0
+
{{mIRC compatibility|5.0}}
−
 
 
−
Added On: 02/04/97
 
  
 
== See Also ==
 
== See Also ==
−
* [[/dcc command - mIRC|/DCC SEND]]
+
* {{mIRC|/dcc}}
 
* [[On filercvd - mIRC|ON FILERCVD]]
 
* [[On filercvd - mIRC|ON FILERCVD]]
 
* [[On filesent - mIRC|ON FILESENT]]
 
* [[On filesent - mIRC|ON FILESENT]]
 
* [[On sendfail - mIRC|ON SENDFAIL]]
 
* [[On sendfail - mIRC|ON SENDFAIL]]
 +
{{mIRC on event list}}
  
−
[[Category:mIRC on events]]
+
[[Category:mIRC on events|getfail]]

Latest revision as of 06:46, 6 February 2024

Commands & Identifiers
Basics
Events
Matching Tools
Data Storage
Control Structures
GUI Scripting
Sockets
Advanced Scripting
Additional Resources
Security
Other
v · d · e

The ON GETFAIL event triggers whenever a remote user sends a file via DCC send and it fails.

Synopsis[edit]

ON <level>:GETFAIL:<filename[,filename]>:<commands>

Parameters[edit]

  • <level> - The corresponding access levels for the event to trigger.
  • <filename> - The filename(s) that should match the received file. Seperate multiple values by commas. These can be wildcards. Example: *.txt,*.doc,my*.txt
  • <commands> - The commands to be performed when the event listener's criteria is met.

local identifiers[edit]

$filename[edit]

Returns the complete filename of the received file.

Examples[edit]

Echo the name of the filename, along with both the user's nickname and address if available: 

ON *:GETFAIL:*:echo -a Failed to receive $filename $iif($nick,from $nick - ,from) Address: $address

Compatibility[edit]

Added: mIRC v5.0
Added on: 02 Apr 1997
Note: Unless otherwise stated, this was the date of original functionality.
Further enhancements may have been made in later versions.


See Also[edit]

v · d · e mIRC on event list

A on Action, on Active, on Agent, on Appactive

B on Ban

C on Char, on Chat, on Chatclose, on Chatopen, on Close, on Connect, on Connectfail, on Ctcpreply

D on Dccserver, on Dehelp, on Deop, on Deowner, on Devoice, on Dialog, on Disconnect, on Dns

E on Error, on Exit

F on Filercvd, on Filesent

G on Getfail

H on Help, on Hotlink

I on Input, on Invite

J on Join

K on Keydown, on Keyup, on Kick

L on Load, on Logon

M on Midiend, on Mode, on Mp3end

N on Nick, on Nosound, on Notice, on Notify

O on Op, on Open, on Owner

P on Parseline, on Part, on Ping, on Playend, on Pong

Q on Queryclose, on Queryopen, on Quit

R on Rawmode

S on Sendfail, on Serv, on Servclose, on Servermode, on Serverop, on Servopen, on Signal, on Snotice,  on Sockclose, on Socklisten, on Sockopen, on Sockread, on Sockwrite, on Start

T on Text, on Topic

U on Udpread, on Udpwrite, on Unban, on Unload, on Unotify, on Usermode

V on Vcmd, on Voice

W on Wallops, on Waveend

Retrieved from "https://en.wikichip.org/w/index.php?title=mirc/on_events/on_getfail&oldid=102212"