From WikiChip
Difference between revisions of "mirc/identifiers/$dll"
< mirc‎ | identifiers

(Compatibility)
 
(One intermediate revision by one other user not shown)
Line 1: Line 1:
 
{{mirc title|$dll Identifier}}'''$dll''' call a function of a dll, and eventually returns a value if the function is made to return a value. More informations about dll {{mIRC|dll|here}}
 
{{mirc title|$dll Identifier}}'''$dll''' call a function of a dll, and eventually returns a value if the function is made to return a value. More informations about dll {{mIRC|dll|here}}
 
  
 
== Synopsis ==
 
== Synopsis ==
<pre>$dll(name.dll,procname,data)</pre>
+
<pre>$dll(name[.dll],procname,data)</pre>
  
== Paramters ==
+
== Parameters ==
* '''name.dll''' - the filename to the dll
+
* '''name.dll''' - the filename to the dll. If filetype not used, assumes filename.dll
 
* '''procname''' - procname, the name of the function in the dll
 
* '''procname''' - procname, the name of the function in the dll
* '''data''' - a string/parameter passed to the function
+
* '''data''' - a text string/parameter passed to the function, which .dll sees as 0x00-terminated, even if procname does not require a data string, you must still pass a null or dummy string. If data should contain a comma, best to place it in a %var or use $chr(44) instead of trying to pass as a literal string.
 
+
== Properties ==
 +
None
 +
== Notes ==
 +
1. Beginning v7.56, filename and filename.dll are both loaded into the $dll(N) list once as filename.dll. Previously they were loaded as 2 different $dll(N) items with 2 different filenames, yet referencing both filename|filename.dll used the memory image associated with the lowest Nth item in the $dll(N) list of the pair.
 
== Example ==
 
== Example ==
  
 
== Compatibility ==
 
== Compatibility ==
 
{{mIRC compatibility|5.6}}
 
{{mIRC compatibility|5.6}}
 
 
== See Also ==
 
== See Also ==
 
* {{mIRC|$dllcall}}
 
* {{mIRC|$dllcall}}
 
* {{mIRC|/dll}}
 
* {{mIRC|/dll}}
 
[[Category:mIRC identifiers|dll]]
 

Latest revision as of 17:34, 6 July 2019

$dll call a function of a dll, and eventually returns a value if the function is made to return a value. More informations about dll here

Synopsis[edit]

$dll(name[.dll],procname,data)

Parameters[edit]

  • name.dll - the filename to the dll. If filetype not used, assumes filename.dll
  • procname - procname, the name of the function in the dll
  • data - a text string/parameter passed to the function, which .dll sees as 0x00-terminated, even if procname does not require a data string, you must still pass a null or dummy string. If data should contain a comma, best to place it in a %var or use $chr(44) instead of trying to pass as a literal string.

Properties[edit]

None

Notes[edit]

1. Beginning v7.56, filename and filename.dll are both loaded into the $dll(N) list once as filename.dll. Previously they were loaded as 2 different $dll(N) items with 2 different filenames, yet referencing both filename|filename.dll used the memory image associated with the lowest Nth item in the $dll(N) list of the pair.

Example[edit]

Compatibility[edit]

Added: mIRC v5.6
Added on: 03 Jun 1999
Note: Unless otherwise stated, this was the date of original functionality.
Further enhancements may have been made in later versions.

See Also[edit]