WinBatch Tech Support Home

Database Search

If you can't find the information using the categories below, post a question over in our WinBatch Tech Support Forum.

TechHome

plus
plus
plus
plus
plus

Can't find the information you are looking for here? Then leave a message over on our WinBatch Tech Support Forum.

List of WIL Extenders

ADSI | Control Manager | CPU | File Searcher | File and Folder Finder | GPIB (No longer supported) | Huge Math | IP Address Grabber | JSON | MAPI | NetWareX (No longer supported) | ODBC | Pixie (No longer supported) | Postie | Printer | Process | RAS | Reggie | Serial | ShellOp | SQLite | Terminal Services | WILX | Win32 Network | WinInet | WinSock | WLAN | Zipper

 

WIL language Extenders are among the most useful parts of the WIL language. Network connectivity, special arithmetic operations, and other capabilities can be added to WIL with Extenders.

Where do I find WIL Extenders?

Extenders are often available on the web site : http://www.winbatch.com/download.html. They may be downloaded from there. The most widely used Extenders are included on the distribution CD-ROM in the 'Extenders' subdirectory.

Can I create my own WIL Extender?

Software developers who want to create custom extensions to the WIL language may purchase a development kit called "WIL Extender SDK. The actual extender must be written as a DLL using C or C++.

Where I can locate the help files for these Extenders?

Each individual extender has a help file that explains how to use the functions in it.


 

ADSI Extender: WWADS44I.DLL/WWADS64I.DLL

Extender download [ wwads44i.zip ]

The WinBatch ADSI extender provides access to the powerful functionality of Microsoft's Active Directory Service Interfaces ( ADSI ) in a style familiar to WinBatch users. With the ADSI extender, you can manage network resources in several directory services with a single, easy to use, set of functions.

Please note: We're assuming you have some prior knowledge of how to use Active Directory Services Interfaces in order to effectively utilize this extender. Along with a general understanding of ADSI, it goes without saying that you will need to have knowledge about the directory service that you will be using this extender to manipulate.

The extender allows you to create directory service objects including users, computers, groups and organizational units. It also allows you to change object attributes and move objects from one location to another. There are special functions for managing object membership in security and distribution groups. In addition, there are functions for investigating the directory structure including LDAP style search functions, and functions for handling Active Directory object security.

To access the functions in this extender, add the following to your script:

AddExtender ( 'WWADS44I.DLL', 0 , 'WWADS64I.DLL' )

 

System Requirements:
32-bit WinBatch version 2004B or newer.


64-bit WinBatch version 2011B or newer.

 

dsAclAddAce ( acl-sec-obj-id, ace-sec-obj-id, position )

Adds an Access Control Entry ( ACE ) to an Access Control List ( ACL ) .

dsAclGetAces ( acl-sec-obj-id, ace-type )

Returns a copy of each Access Control Entry ( ACE ) associated with an Access Control List ( ACL ) as a tab ( @Tab ) delimited list of ACE security object identifiers.

dsAclOrderAce ( acl-sec-obj-id )

Places the Access Control Entries ( ACEs ) of an Access Control List ( ACL ) into Active Directory preferred order.

dsAclRemAce ( acl-sec-obj-id, ace-sec-obj-id )

Removes an Access Control Entry ( ACE ) from an Access Control List ( ACL ) .

dsAddToGrp ( group-ADSI-path, object-ADSI-path )

Adds a directory service object to a group.

dsCopySecObj ( sec-obj-id )

Creates a copy of a security object.

dsCreatSecObj ( ADSI-path, object-type )

Creates a Windows Security Descriptor, Access Control List ( ACL ) or Access Control Entry ( ACE ) depending on the value second parameter.

dsCreateObj ( parent-ADSI-path, object-class, object-name )

Begins a request to create a new directory service object of the specified class and name in the parent container.

dsDeleteObj ( ADSI-path )

Deletes an object from the directory service.

dsFindPath ( ADSI-path, search-filter )

Finds the paths of all LDAP objects that match the criteria specified by the search filter.

dsGetChldPath ( ADSI-path, class-name )

Obtains the ADSI paths of the immediate children of the parent object.

dsGetClass ( ADSI-path )

Returns the schema class name of a directory service object.

dsGetinfo ( request )

Returns information on the ADSI extender.

dsGetMemGrp ( group-ADSI-path )

Returns a delimited list containing the paths of all members of a group.

dsGetPrimGrp ( user-ADSI-path )

Returns the ADSI path of a users Primary group.

dsGetPrntPath ( child-ADSI-path )

Obtains the path of a directory service objects parent.

dsGetProperty ( ADSI-path, property-name )

Gets the property value ( s ) associated with the input property of the input object.

dsGetPropName ( ADSI-Path, property-type )

Returns the names of the properties associated with a directory service object.

dsGetSecProp ( sec-obj-id, property-name )

Retrieves the property values of security objects, including Security Descriptors, Access Control Lists ( ACLs ) and Access Control Entries ( ACEs ) .

dsGetUsersGrps ( user-ADSI-path )

Obtains a list of groups of which a user is a member.

dsisContainer ( ADSI-path )

Determines if a directory service object is a container.

dsisMemberGrp ( group-ADSI-path, object-ADSI-path )

Tests for group membership.

dsisObject ( ADSI-path )

Determines if a directory service path is the path of an existing directory service object.

dsMoveObj ( object-ADSI-path, target-ADSI-path, object-name )

Moves an ADSI object from one container to another.

dsRelSecObj ( sec-obj-id )

Releases a security object associated with the passed in sec-obj-id.

dsRemFromGrp ( group-ADSI-path, object-ADSI-path )

Revokes an objects membership in a directory service group.

dsSetCredent ( user-name, password )

Sets user credentials for all subsequent calls to the extender functions.

dsSetCredentx ( user-name, password, auth-method )

An extended version of the dsSetCredent function that allows you to set the authentication method along with the user name and password.

dsSetObj ( ADSI-path )

Finishes a request to create a new directory service object.

dsSetPassword ( user-ADSI-path, old-password, new-password )

Assigns a password to a newly created user object or changes the password of a user object that already has a password.

dsSetProperty ( ADSI-path, property-name, property-values )

Sets the property value ( s ) of the specified property.

dsSetSecProp ( sec-obj-id, property-name, property-value )

Sets the property values of security objects, including Security Descriptors, Access Control Lists ( ACLs ) and Access Control Entries ( ACEs ) .

dsSidToHexStr ( sddl-sid )

Converts a Security Identifier ( SID ) from Security Descriptor Definition Language ( SDDL ) format to a "hex string" format.


Control Manager Extender: WWCTL44I.DLL/WWCTL64I.DLL

Extender download [ wwctl44i.zip ]

The Control Manager Extender allows near-complete access to all standard Windows controls displayed on the screen, and especially within Dialog Boxes presented by various applications.

Controls include Check Boxes, Radio Buttons, Tabbed Dialogs, List Boxes and Combo Boxes.

To access the functions in this extender, add the following to your script:

AddExtender('WWCTL44I.DLL',0,'WWCTL64I.DLL')

 

System Requirements:
32-bit WinBatch version 2004B or newer.
64-bit WinBatch version 2011B or newer.

 

cCheckBox ( window-handle, flag )

Examines or sets a check box.

cClearLBAll ( window-handle )

Remove the highlighting from all items in either a Single-selection or a Multiple-select List Box.

cClearLVItem ( window-handle, item )

Un-select an item of a List View common control.

cClearTVItem ( window-handle, item-path )

Un-select an item of a Tree View common control.

cClickButton ( window-handle )

Clicks a button, emulating a user.

cClickToolbar ( window-handle, position )

Simulates performing a left mouse button click of a Tool Bar button.

cDblClickItem ( window-handle, item )

Simulate a mouse double click on a List View, Tree View or Header common control.

cEnableState ( window-handle, flag )

Examines or sets the enabled/disabled status of a control.

cFindbyClass ( class-name )

Gets the window handle of the first window whose class name matches the specified "class-name".

cFindbyName ( partial-name )

Gets the window handle of the first window whose window name matches the specified 'partial window name'.

cGetCalDate ( window-handle )

Retrieve the date or date range of a Month Calendar control with this function.

cGetCBCount ( window-handle )

Gets a count of items in a Combo Box control.

cGetCBSelText ( window-handle )

Obtain the selected item from a drop-down combo box.

cGetCBText ( window-handle )

Extracts the text from a drop-down combo box.

cGetControlImageCrc ( window-handle )

Creates a Cyclic Redundancy Check (CRC) value of the on-screen image of a Windows control.

cGetDTPDate ( window-handle )

Return the date and time stored in a Date Time Picker control in standard "datetime" format.

cGetEditText ( window-handle )

Retrieves the contents of an Edit Box.

cGetFocus ( )

Retrieves handle of the window with keyboard focus

cGetHRText ( window-handle )

Return all the text associated with each item of a Header common control.

cGetInfo ( request )

Return extender specific information.

cGetIpAddr ( window-handle )

Get an IP address stored in an IP Address common control.

cGetLBCount ( window-handle )

Get a count of items in a List Box control.

cGetLBText ( window-handle )

Extracts the text from a standard list box.

cGetLBSelText ( window-handle )

Retrieve the text from all highlighted items in either a Single-selection or a Multiple-select List Box control.

cGetLVColText ( window-handle )

Retrieves all the text associated with a column of a List View common control with the Report View style.

cGetLvDdtText ( window-handle )

Returns the text associated with the item, that is the current drag and drop target of a List View common control.

cGetLvFocText ( window-handle )

Retrieve the text associated with the items that have the focus in a List View common control.

cGetLvSelText ( window-handle )

Retrieves the text associated with selected items of a List View common control.

cGetLVText ( window-handle )

Retrieves the text associated with items of a List View common control.

cGetSBText ( window-handle )

Returns the text that may be associated with each part of a Status Bar control.

cGetTBText ( window-handle )

Retrieves the text for each button of a Tool Bar control.

cGetTrackMax ( window-handle )

Get the maximum position of a Track Bar control.

cGetTrackMin ( window-handle )

Get the minimum position of a Track Bar control.

cGetTrackPos ( window-handle )

Get the current position of a Track Bar control.

cGetTVItem ( window-handle )

Obtains the selected item of a Tree View common control.

cGetUpDownMax ( window-handle )

Get the maximum position of an UpDown control.

cGetUpDownMin ( window-handle )

Get the minimum position of an UpDown control.

cGetUpDownPos ( window-handle )

Gets the position of an UpDown control.

cGetWndCursor ( window-handle, request )

Determines an application windows current mouse cursor.

cPostButton ( window-handle )

Clicks a button, emulating a user. This uses an undocumented method, different from cClickButton, that seems to work when cClickButton causes the script to hang.

cPostMessage ( window-handle, msg, wparam, lparam )

The real PostMessage (or PostMessageA if you want to get nitpicky).

cRadioButton ( window-handle, flag )

Examines or sets a radio button.

cSendMessage ( window-handle, msg, wparam, lparam )

The real SendMessage (or SendMessageA if you want to get nitpicky).

cSetCalDate ( window-handle, date-time, date-time )

Set the date or date range of a Month Calendar control with this function.

cSetCBItem ( window-handle, item )

Sets a single item in a standard Combobox.

cSetDTPDate ( window-handle, date-time )

Change the values of a Date Time Picker control.

cSetEditText ( window-handle, text )

Changes the contents of an Edit Box.

cSetFocus ( window-handle )

Set the keyboard focus to the control window specified by the input window handle.

cSetIpAddr ( window-handle, ip-address )

Set an IP address stored in an IP Address common control. T

cSetLBItem ( window-handle, item )

Sets a single item in a standard single item list box. It will not work with a multiple selection listbox.

cSetLBItemEx ( window-handle, item-list )

Select one or more items in a List Box control.

cSetLVItem ( window-handle, item )

Select an item of a List View common control.

cSetTABItem ( window-handle, item )

Selects a tab from a tabbed dialog.

cSetTrackPos ( window-handle, position )

Sets the position of a Track Bar control.

cSetTVItem ( window-handle, item )

Select an item of a Tree View common control.

cSetUpDownPos ( window-handle, position )

Set the position of an UpDown control.

cSetWndText ( window-handle, text )

Change the text associated with a Windows control.

cWinIdConvert ( window-id | window-handle )

Convert between a Windows handle and a Window Id (pseudo-handle)

cWndByClass ( window-handle, classname )

Obtains the handle of a child window or control based on the window or control class.

cWndByID ( window-handle, id )

Obtains the handle of a child window or control based on the window or control ID number.

cWndByName ( window-handle, title )

Obtains the handle of a child window or control based on the window or control title.

cWndBySeq ( window-handle, sequence )

Obtains the handle of a child window or control based on the window or control sequence number.

cWndByWndSpec ( window-class, window-module, child-count [ , child-id...])

Returns a window handle based on the window specifications.

cWndByWndSpecName ( window-title, window-module, child-count [ , child-id...])

Returns the window handle of a top-level window from the window specification generated using a windows title.

cWndExist ( window-handle, window-info, info-type )

Determines if a child window of the specified parent exists.

cWndGetWndSpec ( window-handle )

Creates a window specification from the window handle.

cWndGetWndSpecName ( window-handle )

Creates a window specification from the window handle.

cWndInfo ( window-handle, request )

This function returns information about a window or control.

cWndState ( window-handle )

Get the current state of a window


CPU Extender: WWWCPU44I.DLL

Extender download [ wwcpu44i.zip ]

The CPU Extender allows you to detect CPU type and performance. This can be used to determine information like the CPU generation, manufacturer, or existence of an Overdrive" processor. The functions in this extender work on newer Intel486", all Pentium and later processors, as well as on AMD and Cyrix processors.

To access the functions in this extender, add the following to your script:

AddExtender('WWCPU44I.DLL')

 

System Requirements: WinBatch version 2004B or newer.

 

cCloneCheck ( )

Returns information about Intel CPU processor clones.

cCpuBenchmark ( type, bloop, sloop, numerator, reserved )

This function is designed to provide a quick and easy-to-use CPU benchmark to estimate the raw processing power of a given machine.

cCpuFeat ( )

Returns the CPU Feature Flags as a hexadecimal number.

cCpuid ( )

Returns information about whether the host processor is a Genuine Intel processor or not.

cCpuidExt ( )

Returns the Processor Type, Family, Model, and Stepping as a hexadecimal number.

cMemStat ( )

Returns information on available memory.

cCpuSpeed ( int )

Returns the raw clock rate of the host CPU.

cCpuSupt ( )

Returns whether the host processor supports the CPUID opcode.

cVendorId()

Returns manufacturer of CPU.

cVersionInfo ( 0 )

Returns the DLL version number.

 


File Searcher Extender: WSRCH34I.DLL

Extender download [ wsrch34i.zip ]

The File Search extender can be used to:

Note: In order to use the functions in this extender, you must have the wsrch34i.dll and the witzsrch.dll present.

To access the functions in this extender, add the following to your script:

AddExtender('WSRCH34I.DLL')

 

System Requirements:
32-bit WinBatch version 2004B or newer.


64-bit WinBatch version 2011B or newer.

 

SrchInit ( path, mask, strings, exclude mask, flags )

Returns a search handle to be used by the srchNext and srchFree functions.

SrchNext ( handle )

Finds the next file.

SrchFree ( handle )

Frees memory associated with the search.

srchVersion ( )

Returns the version number of the extender DLL.

 


File and Folder Finder Extender: WWFAF44I.DLL/WWFAF64I.DLL

Extender download [ wsrch34i.zip ]

The File and Folder Finder extender is a streamlined version of the original File Search extender that emphasizes speedy searches for files and folder on local drives and network shares.   

The File and Folder Finder extender can be used to:

  • Find files and folders on the local file system

  • Find files and folders on network shares

  • Find files and folders using wildcard characters

  • Find files and folder in sub directories

  • Use file and folder attributes to narrow search results.

  • The File and Folder Finder extender cannot&

  • Search the contents of a file. (Use the File Search extender instead)

  • Search using Windows shell's special folder names.

Note: To help make the File and Folder Finder extender searches faster, its use is restricted to Microsoft Windows 2000 or newer. This applies to both the client and server versions of the operating system. The original File Search extender can still be used on older versions of Microsoft Windows.

To access the functions in this extender, add the following to your script:

AddExtender('WWFAF44I.DLL',0,'WWFAF64I.DLL')

System Requirements:
32-bit WinBatch version 2004B or newer.


64-bit WinBatch version 2011B or newer.

 

fafClose ( context-handle )

Releases all resources associated with a search context handle.

fafFind ( context-handle )

Starts or continues a file system search using the indicated search context.

fafGetInfo ( request-code )

Returns information about the File and Folder Search extender.

fafOpen ( root-path, file-mask [, flags] )

Opens a search context for use with the fafFind and fafClose functions.

 


GPIB Extender:

Extender download [ No longer supported. ]

These functions allow access to the standard GPIB variables and other information.

Note: There are two different extender DLLS included in this package.

  • wwgpibcb.dll - For the ComputerBoards (and compatible) GPIB cards.

  • wwgpibni.dll- For the National Instruments (and compatible) GPIB cards.

Use the one appropriate for your hardware.

System Requirements: WinBatch version 2001A or newer.

488 GPIB Variable Extraction Functions

ibSta ( )

Retrieves "ibsta" status information

ibCnt ( )

Retrieves"ibcnt" 16-bit counter information

ibCntl ( )

Retrieves"ibcntl" 32-bit long counter information

ibErr ( )

Retrieves "iberr" error information

WIL Utility Functions

ibGetPad ( addr4882_t )

Gets the Primary Address portion of a 16 bit GPIB address

ibGetSad ( addr4882_t )

Gets the Secondary Address portion of a 16 bit GPIB address

ibMakeAdd

Makes a 16 bit addr4882_t 16 bit GPIB address from the PAD and SAD portions of the address

ibStatus ( )

Retrieves formatted status/error information

488.1 GPIB Variable Extraction Functions:

ibAsk ( handle, option )

Asks Configuration info

Obtains software configuration information

ibBna ( handle, boardname )

Board New Address

Reconfigures a device to use a different access board

ibCac ( handle, async )

Configure Active Controller

Configures a board to become the Active Controller

ibClr ( handle )

Clear

Clears a device

ibCmd ( handle, commands, bytecount )

Command

Issues GPIB commands

ibCmda ( handle, commands, bytecount )

Command Async

Issues GPIB commands asynchronously

ibConfig ( handle, option, value )

Configure

Configures or reconfigures a GPIB board or device

ibDev ( GPIBIndex, padsad, timeout, eot, eos )

Device definition

Opens a handle and initializes a device

Sets device to be online

ibDma ( handle, flag )

Direct Memory Access control

Use to enable to disable Direct memory Access

ibEos ( handle, eosmode )

End-Of-String software configuration

ibEot ( handle, eotflag )

End of Text mode

Control whether or not the GPIB EOI line is set after the end of a I/O Write operation

ibEvent ( handle )

Obtains the oldest recorded event

ibFind ( name )

Find device

Opens a handle and initializes a device

Sets device to be online

ibGts ( handle, handshake )

Go To Standby

Places a controller into Standby mode

ibInit ( handle )

Re-Initialize board, reload configuration info

ibIst ( handle, flag )

Individual STatus bit settings

Sets or clears the IST ( Individual STatus bit ) on

GPIB boards for parallel polls

ibLines ( handle )

Interrogate the GPIB board control lines

ibLn ( handle, pad, sad )

Listener

Check to see if a listener device is on the bus

ibLoc ( handle )

Local Mode

Causes a GPIB device or board to go into Local mode

ibOnl ( handle, flag )

Online / Offline

Places a board or device in an online or offline state

ibPad ( handle, pad )

Primary Address change

Changes the primary address of a board or device

ibPct ( handle )

Pass Control To

Pass GPIB bus control to a different GPIB device

that has Controller capability

ibPpc ( handle, command )

Parallel Poll Configure

Configures the parallel polling of a device

ibRd ( handle, maxcount )

Read

Reads data from a device into a string

ibRdf ( handle, filename )

Read into File

Reads data from a device into a disk file

ibRpp ( handle )

Request Parallel Poll

ibRsc ( handle, flag )

Request or Release System Control

ibRsp ( handle )

Request Serial Poll

ibRsv ( handle, byte )

Reset Serial Value

Change the serial poll response byte and optionally

request service from the Controller in Charge

ibSad ( handle, sad )

Secondary Address change

Changes or removes the secondary address

of a board or device

ibSic ( handle )

Signal Interface Clear

Signal the IFC ( Interface Clear ) line to

re-initialize the GPIB bus

ibSre ( handle, flag )

Set Remote Enable

Allow devices to be put into a remote controlled state

ibStop ( handle )

Stop Asynchronous Operations and

re-enter synchronous mode

ibTmo ( handle, timeout )

TimeOut value modification

Temporarily modifies the timeout of a board or device

ibTrg ( handle )

Trigger

Triggers a device to perform a previously requested action

ibVersion ( request code )

Version

Returns extender version number or extender type.

ibWait ( handle, events )

Wait

Wait for specified events to occur

ibWrt ( handle, string, count )

Write

Writes data to a GBIB device or board

ibWrtf ( handle, filename )

Write File

Writes data from a file to a GBIB device or board

488.2 GPIB Variable Extraction Functions:

AllSPoll ( boardnum, addresslist )

Performs a serial poll on all of a specified list of devices

DevClear ( boardnum, address )

Device Clear

Clears a single device

DevClearList ( boardnum, addresslist )

Device Clear a list of devices

EnableLocal ( boardnum, addresslist )

Place a list of devices into Local ( Front-Panel ) Mode

EnableRemote ( boardnum, addresslist )

Place a list of devices into Remote Mode

Note that the deive will not enter Remote mode until commanded to do so by the Controller

FindLstn ( boardnum, addresslist )

Find Listeners

Find all devices in a list that are listening to the GPIB bus

FindRQS ( boardnum, addresslist )

Find device Requesting Service

PassControl ( boardnum, address )

Pass Control so that another device becomes the Active Controller

The new device needs to have Controller capability

PPoll ( boardnum )

Parallel Poll

Perfroms a Parallel Poll of pre-configured devices

PPollConfig ( boardnum, address, dataline, ISTsense )

Parallel Poll Configure

Assigns parallel poll response bits to various devices

PPollUnconfig ( boardnum, addresslist )

Parallel Poll Unconfigure

RcvRespMsg ( boardnum, count, termination )

Receive Response Message

Receive data from a device previously instructed to provide a response

ReadStsByte ( boardnum, address )

Read Status Byte from a device

Receive ( boardnum, count, address, termination )

Receives data from a GPIB device

ReceiveSetup ( boardnum, address )

Sets up a board and device to transfer data on a subsequent RcvRespMsg function call

ResetSys ( boardnum, addresslist )

Reset System

Send ( boardnum, address, data, count, eotmode )

Sends data to a GPIB device

SendCmds ( boardnum, commands, count )

Send GPIB Multiline Interface commands

SendDataBytes ( boardnum, data, count, eotmode )

Send Data bytes to a device previously instructed to listen for a command string

SendIFC ( boardnum )

Send the IFC ( Interface Clear ) signal to re-initialize the GPIB system

SendList ( boardnum, addresslist, data, count, eotmode )

Sends data to a list of GPIB devices

SendLLO ( boardnum )

Send the Local Lockout command to all GPIB devices

SendSetup ( boardnum, addresslist )

Sets up to send data to a specified list of GPIB devices

SetRWLS ( boardnum, addresslist )

Set all specified devices into the Remote with local Lockout State and instructs the devices to become Listeners

TestSRQ ( boardnum )

Tests the state of the Service Request ( SRQ ) signal on the GPIB board

TestSys ( boardnum, addresslist )

Test System

Instructs a specified list of devices to perfrom a self-test

Trigger ( boardnum, address )

Trigger a device to perform some pre-specified action

TriggerList ( boardnum, addresslist )

Triggers a specified list of devices

WaitSRQ ( boardnum )

Wait for a GPIB device to signal Service Request (SRQ )


Huge Math Extender: WWWHUG44I.DLL/WWWHUG64I.DLL

Extender download [ wwhug34i.zip ]

The Huge Arithmetic Extender contains a few functions which allows simple high-precision math on extremely large numbers (up to 2000 digits).

To access the functions in this extender, add the following to your script:

AddExtender('WWWHUG44I.DLL',0,'WWWHUG64I.DLL')

 

System Requirements:
32-bit WinBatch version 2004B or newer.


64-bit WinBatch version 2011B or newer.

 

huge_Add ( num1, num2 )

Adds num1+num2.

huge_Decimal ( decimals )

Sets the number of decimal places to be used.

huge_Divide ( num1, num2 )

Divides num1/num2.

huge_ExtenderInfo ( request )

Return Extender Information.

huge_GetLastError

Returns lasterror code if any.

huge_Multiply ( num1, num2 )

Multiplies num1*num2.

huge_SetOptions ( UsePrecision, MaximumDivisionPrecision, FixedPrecision, AddThousandsSeparator, SeparatorFormat, Decimal, Thousands )

Set options for operations..

huge_Subtract ( num1, num2 )

Subtracts num1-num2.

huge_Thousands ( request )

Set Separator.

Useful User Defined Function (UDF)

UDFCvtFloatToHuge ( number )

Converts a floating point number to a high-precision decimal number suitable for use by the hugemath extender.

UDFHuge_Compare ( num1, num2 )

The UDFHuge_Compare UDF will compare two huge numbers and return a value.

UDFHuge_Max ( num1, num2 )

The UDFHuge_Max UDF will return the larger of two parameters.

UDFHuge_Min ( num1, num2 )

The UDFHuge_Min UDF will return the smaller of two parameters.


IP Address Grabber Extender: WWIPG44I.DLL/WWIPG64I.DLL

Extender download [ wwipg44i.zip ]   

The IP Grabber Extender contains a few functions which allow you to retrieve IP address information.

To access the functions in this extender, add the following to your script:

AddExtender('WWIPG44I.DLL',0,'WWIPG44I.DLL')

 

System Requirements:

  • The IP grabber extender requires the current version of WinSock 2 to function properly, or else it will get an error on the AddExtender line.

  • WinBatch 2004F or newer is required to use this version of the IP Grabber extender.

  • 32-bit WinBatch version 2004B or newer.

  • 64-bit WinBatch version 2011B or newer.

  • Windows 95 with no service packs will not work and requires an update from http://www.microsoft.com Enter&Windows Socket 2 Update in the search box to locate the update.

ipAddr2Host ( host address, timeout )

Converts a host address into an host name.

ipGetAddress ( )

Returns a doubly-delimited list of all IP addresses found along with other related information.

ipGetLastErr ( )

Returns last runtime error number.

ipHost2Addr ( host name, timeout )

Converts a host name into a host address.

ipMacAddrAllFmt ( )

List of all Ethernet adapters MAC addresses, as formatted strings of hexadecimal numbers.

ipMacAddrAllRaw ( )

List of all Ethernet adapters MAC addresses, as raw strings of hexadecimal numbers.

ipMacAddrFirstFmt ( )

Get the MAC address of the first Ethernet adapter, as a formatted string of hexadecimal numbers.

ipMacAddrFirstRaw ( )

Get the MAC address of the first Ethernet adapter, as a raw string of hexadecimal numbers.

ipPing ( hostname/address, timeout )

Determines if the specified host is responding.

ipVersion ( request )

Returns extender version number information.


JSON Extender: ILCJS44I.DLL/ILCJS64I.DLL

Extender download [ ilcjs44i.zip ]   

The JSON extender provides WinBatch scripts easy access to JSON data.

To access the functions in this extender, add the following to your script:

AddExtender('ILCJS44I.DLL',0,'ILCJS44I.DLL')

 

System Requirements:

  • The JSON extender requires Windows Vista/2008 or newer.

  • WinBatch 2005C or newer is required to use this version of the JSON extender.

  • 32-bit WinBatch version 2005C or newer.

  • 64-bit WinBatch version 2011B or newer.

jsConClose ( [container-handle] )

Releases all resources associated with an JSON container or resources associated with all open JSON containers.

jsConMap ( container-handle, value-or-type )

Creates a WIL map containing the key and either each key's value or the JSON type of each key's value.

jsConNew ( container-tytpe )

Creates and returns a new empty JSON container.

jsGetInfo ( option )

Retrieves the extender version and other information about the extender.

jsKeyExist ( container-handle, key-name [, ptr-paths [, key-delimiter]] )

Searches containers and sub-containers for all occurrences of a key or index and returns the number of instances found.

jsKeyPaths ( object-handle, key-name [, keys-delimiter ])

Searches containers for key(s) and returns all JSON paths to the key or keys.

jsParse ( json-string )

Creates a JSON container handle representing the parsed contents of a string containing valid JSON.

jsSerialize ( container-handle, formated[, encoding] )

Converts a JSON container handle into a string containing the contents of the JSON container.

jsValid (json-string)

Determines if a string contains valid JSON.

jsValueAdd ( container-handle, key-path, value [, key-delimiter ] )

Adds a key with value or changes the value of an existing key in a JSON container.

jsValueGet ( container-handle, key [, key-delimiter ] )

Retrieves the value associated with a key contained in a JSON container.

jsValueType ( container-handle, key [, key-delimiter ] )

Retrieves the JSON data type of the value associated with a contained in a JSON container.


MAPI Extender: WWMAP44I.DLL

Extender download [ wwmap44i.zip ]

The Simple Mapi Extender contains a few functions which enables you to send and retrieve email via MAPI (Messaging Application Program Interface). A messaging architecture and a client interface component. As a messaging architecture, MAPI enables multiple applications to interact with multiple messaging systems across a variety of hardware platforms. This extender is limited to simple MAPI-type operations.

To access the functions in this extender, add the following to your script:

AddExtender('WWMAP44I.DLL')

 

System Requirements:

  • WinBatch version 2004B or newer.

  • This extender requires a Full MAPI Client in order to work, such as: Microsoft Exchange, Windows Messaging, Microsoft Exchange Server Client or Outlook [the fullversion, not Express].

 

mAddress ( )

Access the address list user interface.

mCompatible ( )

Checks to see if user's system can support this extender.

mError ( )

Returns extender error info.

mFindNext ( handle, message-id, flag )

Retrieves the next ( or first) message identifier of a message.

mLogOff ( handle )

Logs off of a MAPI session.

mLogOn ( profile-name )

Logs on to a MAPI session and returns a MAPI session handle.

mReadNextMsg ( logon-handle, seed message-id, flag )

Retrieves a message for reading.

mSendMail ( email address, subject, text, attach, profile )

Sends an email message via MAPI.

mSendMailEx ( email-address, subject, text, attach, profile [, flag] )

Sends an email message via MAPI. Handles multiple recipients and attachments.

mSyncMail ( profile-name, transport, flag )

Forces all messages waiting to be sent or received to be immediately uploaded or downloaded.

mVersion ( )

Returns extender version


NetwareX Extender: WWNWX44I.DLL [ No longer supported. ]

Extender download [ wwnwx44i.zip ]

Novell NetWare extender.

To access the functions in this extender, add the following to your script:

AddExtender('WWNWX34I.DLL')

 

System Requirements:

  • Novell Client v4.90SP2 or newer.

  • The NetWareX extender, as of v34001, requires the use of WinBatch+Compiler 2001N or newer. WinBatch+Compiler 2001A through 2001M do not implement the extender feature level 1002 that this version of the extender requires.

nwAddObject ( object-spec, operation, attr-name, attr-value, binbuf-addr, binbuf-size, flags )

Creates an NDS object..

nwAddUserToGroup ( group-spec, user-spec )

Add a user to a group.

nwAttachToServer ( host-spec, flags )

Establish a connection to a server.

nwChgPassword ( obj-spec, oldpwd, newpwd, flags )

Changes the password on an object ( e.g. a user ) .

nwClientInfo ( request )

Returns information about the Novell Client.

nwCompareObject ( object-spec, attr-name, attr-value, binbuf-addr, binbuf-data-size, data-flags )

Compares an object's attribute to see if it is equal to a specified value.

nwDelConnNum ( server-spec, conn-num )

Deletes a connection number a server's connection table.

nwDelUserFromGroup ( group-spec, user-spec )

Remove a user from a group

nwDetachFromServer ( host-spec, flags )

Disconnect a connection from a server.

nwDrivePath ( drive-letter )

Returns a string containing the path of a drive letter that is mapped to a NetWare server.

nwDriveStatus ( drive-letter )

Returns a bit flag value indicating the status of a particular drive letter.

nwGetAttrInfo ( tree-spec, attr-name )

Gets a list of defined attributes or the full definition of a specified attribute.

nwGetBcastMode ( server-spec )

Gets the broadcast mode setting for a server connection

nwGetCapture ( port-number, request )

Gets the current printer port capture settings for a specified printer port.

nwGetConnInfo ( server-spec, request, altparam1, altparam2 )

Returns information about connections that are active on a NetWare file server.

nwGetContext ( request, tree-name )

Returns NDS context information.

nwGetDirInfo ( dir-spec, request, altparam1, altparam2, flags )

Returns information about a directory on a NetWare volume.

nwGetDirLimit ( dir-spec, flag )

Returns directory space limits for a directory.

nwGetFileInfo ( file-spec, request, altparam1, altparam2, flags )

Returns information about a file on a NetWare volume.

nwGetMapped ( server-spec )

Returns a string containing the list of drive letters that are mapped to the specified NetWare server.

nwGetNLMInfo ( server-spec, request, altparam1 )

Returns information about NLMs loaded on a NetWare 4.x or newer file server.

nwGetOptions ( request )

Returns NDS option settings.

nwGetObjInfo ( object-spec, request )

Returns information about the object that has been specified.

nwGetObjValue ( object-spec, attribute, binbuf-addr, binbuf-size, flag[, mod-time] )

Returns information about the object that has been specified.

nwGetSrvCfg ( server-spec, request, altparam1 )

Returns configuration information for a NetWare 4.x or newer file server.

nwGetSrvInfo ( server-spec, request, altparam1 )

Returns information about a NetWare server.

nwGetSrvParam ( server-spec, request, altparam1 )

Returns information about a NetWare server's "SET" command parameters.

nwGetSrvStats ( server-spec, request, altparam1 )

Returns statistical information for a NetWare 4.x or newer file server.

nwGetVolLimit ( volume-spec, user-spec, flag )

Returns volume space limits for a user.

nwIsUserInGroup ( group-spec [, user-spec] )

Check to see if a user is a member of a group

nwLastErrMsg ( error_code )

Returns an error message string.

nwListGroupMembers ( group-spec )

List all of the members in a group

nwListObjects ( base-object, pattern, class, flags[, mod-time] )

Lists objects located within a specified container in NDS.

nwListUserGroups ( [user-spec] )

List all of the groups to which the user belongs

nwLogin ( host-spec, user-spec, password [, flags [, bind-obj-type ] ] )

Login to a NDS tree or to a Bindery server

nwLogout ( host-spec, flags )

Login to a NDS tree or to a Bindery server

nwMap ( net-path, local-name, flag )

Connects a drive letter to a volume on a NetWare server.

nwMapDelete ( local-name )

Disconnectes a drive letter from a volume on a NetWare server.

nwModifyObject ( object-spec, operation, attr-name, attr-value, binbuf-addr, binbuf-size, flags )

Modifies an object's attributes and/or attribute values.

nwMoveObject ( object-spec, new-object-spec, flags )

Moves and/or renames an object in NDS.

nwMutateObject ( object-spec, new-class-name, flags )

Mutates an object in NDS.

nwNameConvert ( object-spec,request )

Converts an object name from one format to another.

nwReceiveBcastMsg ( server-spec )

Receives a stored broadcast message from a server

nwRemoveObject ( object-spec )

Removes/deletes an object from NDS.

nwRenameObject ( object-spec, new-object-name, flags )

Renames an object in NDS.

nwSearchFilter ( tree-spec, token, value, binbuf-addr, binbuf-size, flags )

Constructs [or deallocates] a NDS search filter.

nwSearchObjects ( base-object, pattern, class, flags [, mod-time] )

Searchs for objects located within a specified portion of a NDS tree.

nwSendBcastMsg ( server-spec, request, recipient, altparam2, message [, flags ] )

Sends a Novell broadcast message on the network.

nwServerList ( request, altparam1 )

Returns a string containing a list of one or more server or tree names depending on the value of "request".

nwSetBcastMode ( server-spec, mode )

Gets the broadcast mode setting for a server connection

nwSetContext ( request, context, tree )

Sets local/global NDS context information.

nwSetDirInfo ( dir-spec, request, altparam1, altparam2, flags )

Sets information for a directory on a NetWare volume.

nwSetDirLimit ( dir-spec, limit )

Sets or removes a directory space limit for a directory.

nwSetFileInfo ( file-spec, request, altmaram1, altparam2, flags )

Sets information for a file on a NetWare volume.

nwSetOptions ( request, value )

Modifies NDS option settings.

nwSetPassword ( obj-spec, newpwd, flags )

Sets the password on an object ( e.g. a user ) .

nwSetPrimServ ( server-spec )

Sets the Novell Client's primary server connection to the specified server.

nwSetSrvInfo ( server-spec, request, altparam1 )

Sets configurable information on a NetWare server.

nwSetSrvParam ( server-spec, cmdname, cmdtype, cmdvalue )

Sets a new value for a "SET" command on a NetWare server.

nwSetVolLimit ( volume-spec, user-spec, limit )

Returns volume space limits for a user.

nwSrvExecNCF ( server-spec, ncf-spec )

Executes an NCF file on the console of a NetWare server.

nwSrvGenGUID ( server-spec )

Obtains a newly generated GUID value froma NetWare 5.x or newer file server.

nwSrvNLMMgr ( server-spec, request, nlm-spec )

Performs NLM management functions on a NetWare server.

nwSrvShutdown ( server-spec, flag )

Performs a remote shutdown on a NetWare server.

nwVersion ( request )

Returns the NetWareX extender version number.

nwVfyPassword ( obj-spec, password, reserved )

Verifies the password on an object ( e.g. a user ) .

nwWhoAmI ( host-spec )

Identifies the current user.


ODBC Extender: WWODB44I.DLL

Extender download [ wwodb44i.zip ]

NOTE: In general, ADO is now recommended for use instead of ODBC. Microsoft® ActiveX® Data Objects (ADO) enables your client applications to access and manipulate data from a variety of sources through an OLE DB provider. Its primary benefits are ease of use, high speed, low memory overhead, and a small disk footprint.

The ODBC extender has a basic set of 32-bit ODBC functions. Using Open DataBase Connectivity (ODBC): A standard for accessing different database systems.

To access the functions in this extender, add the following to your script:

AddExtender('WWODB44I.DLL')

 

System Requirements: WinBatch version 2004B or newer.

IMPORTANT:

WinBatch is a 32 bit application. The current version of WinBatch has been thoroughly tested on 64 bit platforms. However, because the ODBC Extender is compiled as a 32 bit DLL, it acts as a 32 bit App. All of the ODBC operations are treated as 32 bit operations on 64 bit platform. The ODBC Extender would have to be compiled as a 64 bit dll in order to handle 64 bit DSNs.

It's important to understand which kind of DSN you have. On an 64 bit system, you can create an ODBC connection(DSN) on the 32-bit side of the system or on the 64-bit side of the system. 32-bit applications will only see ODBC connections created in the 32-bit side, and 64-bits applications will only see ODBC connections from the 64-bit side. Each kind of application has its own registry.

To setup DSN for 32-bit application you must use the ODBC Extender function qConfigData or %WINDIR%SysWOW64odbcad32.exe

To setup DSN for 64-bit application you must use %WINDIR%System32odbcad32.exe

 

qAllocConnect ( henv )

Allocates an SQL connection handle.

qAllocEnv ( )

Allocates an SQL environment handle.

qAllocStmt ( hdbc )

Allocates an SQL statement handle.

qBindCol ( hstmt, col, varname, max-size )

Binds a column in a result set to a WIL variable.

qColumns ( hstmt, table-qualifier, table-owner, table-name, column-name )

Fills a result set with a list of column names in specified tables.

qConfigData ( request-flag , driver, attributes, display-flag )

Configure ODBC data source names.

qConfigError ( )

Returns error or status information if qConfigData fails

qConnect ( hdbc, data-source, user-ID, auth-string )

Connects to a data source.

qDataSources ( henv, direction )

Returns a data source name and description from the list of available data sources.

qDisconnect ( hdbc )

Closes a connection to a data source.

qDriverCon ( hdbc, connect string, prompt user )

An alternative to qConnect.

qDriverList (   )

Returns a list of descriptions of the installed drivers.

qError ( handle, type )

Returns SQL error or status information.

qExecDirect ( hstmt, statement )

Executes an SQL statement.

qFetch ( hstmt )

Fetches a row of data from a result set.

qFreeConnect ( hdbc )

Frees an SQL connection handle.

qFreeEnv ( henv )

Frees an SQL environment handle.

qFreeStmt ( hstmt, option )

Resets or frees an SQL statement handle.

qGetData ( hstmt, col, varname, max-size )

Retrieves the value of a column in the current row of a result set.

qLastCode ( )

Returns the return code that was set by the last SQL function.

qNativeSql ( hdbc, SQL-string )

Returns an SQL string as translated by the driver.

qNumRsltCol ( hstmt )

Returns the number of columns in a result set.

qSetConnOpt ( hdbc, option, value, string-flag )

Sets options for SQL connections.

qSpecial ( p1, p2, p3, p4, p5 )

Returns either real SQL connection handle or module handle to ODBC32.DLL

qTables ( hstmt, table-qualifier, table-owner, table-name, table-type )

Fills a result set with a list of table names stored in a specified data source.

qTransact ( handle, handle-type, operation )

Requests a commit or rollback operation.

qVersionInfo ( request )

Returns information on the ODBC extender.


Pixie Extender: WWIMG44I.DLL [ No longer supported. ]

Extender download [ wwimg44i.zip ]

With the WIL Pixie Extender, you can automate image manipulation, including resizing, sharpening, rotating, and adding other special effects to a large number of images, thereby creating images dynamically en mass.

The Pixie Extender is a robust tool box that provides functions to read and write images in the following formats: GIFs, JPEGs, BMPs, and can read some other file formats.

Note: Pixie can read but not create true GIF files due to LZW compression patent issues. If a GIF file is specified as an output file, Pixie will create a GIF-compatible image file. The GIF-compatible image file will be substantially larger than a true GIF file, but should be compatible with most GIF display programs.

To access the functions in this extender, add the following to your script:

AddExtender('WWIMG44I.DLL')

 

System Requirements: WinBatch version 2004B or newer.

 

ImgVersion ( )

Returns information about this extender.

Converting Images:

ImgConvert ( filename, new-image )

Convert one image format to another.

Image Information:

ImgGetColorCount ( filename )

Returns the number of unique colors in an image.

ImgGetImageType ( filename )

Returns the type of image.

ImgIsGray ( filename )

Determines if an image is grayscale.

ImgIsMono ( filename )

Determines if an image is monochrome.

ImgIsPalette ( filename )

Determines if an image has 256 unique colors or less.

ImgInfo ( filename )

Returns information about an image.

ImgCompare ( filename )

Compares two images for similarity in spatial layout and color.

ImgIsValid ( filename )

Determines if an image is readable by Pixie.

Image Effects:

ImgAddNoise ( filename, new-image, noise-type)

Adds random noise to the image.

ImgBlur ( filename, new-image, radius, sigma )

Blurs an image.

ImgCharcoal ( filename, new-image, radius, sigma )

Creates a new image that is a copy of an existing one with the edge highlighted, giving it a charcoal drawing effect.

ImgChop ( filename, new-image, width, height, x, y )

Removes a region of an image and collapses the image to occupy the removed portion.

ImgColorize ( filename, new-image, opacity, target )

Blends the fill color with each pixel in the image.

ImgCrop ( filename, new-image, width, height, x, y )

Extracts a region of the image.

ImgEmboss ( filename, new-image, radius, sigma )

Creates a grayscale image with a three-dimensional embossed effect.

ImgEnhance ( filename, new-image )

Applies a digital filter that improves the quality of a noisy image.

ImgFlip ( filename, new-image )

Creates a vertical mirror image by reflecting the pixels around the central x-axis.

ImgFlop ( filename, new-image )

Creates a horizontal mirror image by reflecting the pixels around the central y-axis.

ImgGaussianBlur ( filename, new-image, radius, sigma )

Another algorithm that blurs an image.

ImgImplode ( filename, new-image, amount )

Creates a new image that is a copy of an existing one with the image pixels "imploded'" by the specified percentage.

ImgMedianFilter ( filename, new-image, radius )

Another algorithm that applies a digital filter that improves the quality of a noisy image.

ImgMotionBlur ( filename, new-image, radius, sigma, angle )

Simulates motion blur.

ImgOilPaint ( filename, new-image, radius )

Applies a special effect filter that simulates an oil painting.

ImgReduceNoise ( filename, new-image, radius )

Smooths the contours of an image while still preserving edge information.

ImgRotate ( filename, new-image, degrees )

Creates a new image that is a rotated copy of an existing one.

ImgShade ( filename, new-image, shading, azimuth, elevation )

Shines a distant light on an image to create a three-dimensional effect.

ImgSharpen ( filename, new-image, radius, sigma )

Sharpens an image.

ImgUnsharpMask ( filename, new-image, radius, sigma, amount, threshold )

Another algorithm that sharpens an image.

ImgShear ( filename, new-image, x_shear, y_shear )

Creates a new image that is a sheared image copy of an existing one. Shearing slides one edge of an image along the X or Y axis, creating a parallelogram.

ImgSolarize ( filename, new-image, threshold )

Applies a special effect to the image, similar to the effect achieved in a photo darkroom by selectively exposing areas of photo sensitive paper to light.

ImgSpread ( filename, new-image, radius )

A special effects method that randomly displaces each pixel in a block defined by the amount parameter.

ImgSwirl ( filename, new-image, degrees)

Swirls the pixels about the center of the image, where degrees indicates the sweep of the arc through which each pixel is moved.

ImgThreshold ( filename, new-image, threshold)

Changes the value of individual pixels based on the intensity of each pixel compared to threshold.

ImgWave ( filename, new-image, amplitude, wave_length )

Creates a "ripple" effect in the image by shifting the pixels vertically along a sine wave whose amplitude and wavelength is specified by the given parameters.

Enhance an Image:

ImgContrast ( filename, new-image, sharpen )

Enhances the intensity differences between the lighter and darker elements of the image.

ImgEqualize ( filename, new-image )

Applies a histogram equalization to the image.

ImgGamma ( filename, new-image, gamma )

Gamma-corrects an image.

ImgLevel ( filename, new-image, levels )

Adjusts the black, mid, and white levels of an image.

ImgModulate ( filename, new-image, modulate )

Lets you control the brightness, saturation, and hue of an image.

ImgNegate ( filename, new-image, grayscale )

Negates the colors in the reference image.

ImgNormalize ( filename, new-image )

Enhances the contrast of a color image by adjusting the pixels color to span the entire range of colors available.

Framing Images:

ImgBorder ( filename, new-image, width, height, border_color )

Surrounds the image with a border of the color defined by the bordercolor parameter.

ImgFrame ( filename, new-image, width, height, inner_bevel, outer_bevel, border_color )

Adds a simulated three-dimensional border around the image.

ImgRaise ( filename, new-image, bevel, raise )

Creates a simulated three-dimensional button-like effect by lightening and darkening the edges of the image.

Sizing Images:

ImgMagnify ( filename, new-image )

Scales an image proportionally to twice its size.

ImgMinify ( filename, new-image )

Scales an image proportionally to half its size.

ImgResize ( filename, new-image, width, height, filter, blur )

Scales an image to the desired dimensions with a filter algorithm.

ImgSample ( filename, new-image, width, height )

Scales an image to the desired dimensions with pixel sampling.

ImgScale ( filename, new-image, width, height )

Changes the size of an image to the given dimensions.


Postie Extender: WWPST44I.DLL

Extender download [ wwpst44i.zip ]

The WIL Postie Extender adds to WinBatch the ability to handle multi-part MIME as well as UUE encoded email attachments, SMTP/NNTP (Usenet) posting, POP3/IMAP4 email retrieval and posting, and IMAP4 mail management.

The Postie extender wants a DNS served IP address. However many people have found that by simply putting an entry for that IP address in your HOSTS file, you can circumvent the need for a DNS lookup. Note however that the HOSTS file is often updated by other mail programs. To make changes to this file, look for a HOSTS.SAM file in your Windows directory and examine it. It usually has some comments that tell you how to set it up. You may have to reboot to make it effective.

For any of the Postie functions, note that only one mailbox can be selected at a time in a connection. Simultaneous access to multiple mailboxes requires multiple connections via new WinBatch sessions.

To access the functions in this extender, add the following to your script:

AddExtender('WWPST44I.DLL')

 

System Requirements: WinBatch version 2004B or newer.

kDeletePop3 ( msgnum )

The kDeletePop3 function deletes incoming POP3 messages before they have been downloaded to the client. This is not designed to work with IMAP4 clients.

kDest ( tolist, cclist, bcclist )

Required function to set up global variables for other functions in this extender.

kExtra ( charset, encoding, 0, 0, 0 )

This function can be used to set the character-set to be used in the MIME headers. You can also use this function to force base64 encoding for the Subject, To and From address headers, along with the message body and attachments.

kGetMail ( msgnumber, outputfile, pattern, mailfolder, flags )

The kGetMail function can be used to retrieve email messages from the server (not from the email client) including attachments, from both POP3 (Post Office Protocol) and IMAP4 (Internet Message Access Protocol, Version 4) accounts.

kInit ( host, fromaddr, userid, password, port )

This function initializes and sets a number of global variables, to be used in the kSendText, kSendFile, kGetMail, and kManageImap4 functions.

kManageImap4 ( keyword, mailfolder )

The Internet Message Access Protocol, Version 4 allows a client to access and manipulate electronic mail messages on a single server. kManageImap4 permits manipulation of remote message folders, called "mailboxes", in a way that is functionally equivalent to local mailboxes.

kSendFile ( subject, msgfilename, attachments, flags )

The kSendFile function can be used to handle quite a few different tasks, such as SMTP (Simple Mail Transfer Protocol), ESMTP (Enhanced Simple Mail Transfer Protocol), OR NNTP (Network News Transport Protocol). It can also be used for uuencoding attachments or messages before sending (the default attachment setting is MIME format). Note that IMAP4rev1 does not specify a means of posting mail; this functionality is handled by the SMTP mail transfer protocol.

kSendText ( subject, message, attachments,flags )

This function can be used for a multitude of activities. For example, it can be used for SMTP (Simple Mail Transfer Protocol), ESMTP (Enhanced Simple Mail Transfer Protocol), OR NNTP (Network News Transport Protocol). It can also be used for uuencoding attachments or messages before sending (the default attachment setting is MIME format). Note that IMAP4rev1 does not specify a means of posting mail; this functionality is handled by the SMTP mail transfer protocol.

kStatusInfo ( )

The kStatusInfo function returns success and error message details about the last function executed before kStatusInfo is called.

kVerInfo ( request )

Returns the DLL version number.


Printer Extender: WWPRT44I.DLL

Extender download [ wwprt44i.zip ]

The Printer Extender allows you to access and manipulate printer information. The functions are useful for getting and setting the default printer. For a comprehensive list of functions, take a look at the Complete Function List.

To access the functions in this extender, add the following to your script:

AddExtender ( 'WWPRT44I.DLL')

 

System Requirements: WinBatch version 2004B or newer.

 

pAddPrinter ( server-name, printer-name, port-name, driver-name, print-processor )

Adds a printer to the list of supported printers for a server.

pAddPrtConn ( server-name, printer-share-name )

Adds a connection to a printer for the current user.

pDelPrinter ( printer-name )

Removes an installed printer.

pDelPrtConn ( server-name, printer-name )

Removes a connection to a printer.

pGetDefPrtInf ( request )

Get info on default printer.

pGetErrorCode ( )

Get extended error code.

pGetErrorMsg ( )

Get extended error message.

pGetPrtAttrib ( attributes )

Get printer attribute.

pGetPrtInfo ( printer-name, request )

Gets information about a printer.

pGetPrtList ( request )

Get printer list.

pGetPublish ( printer-name )

Determines whether a printer is published in the DS.

pPaperBins ( printer-name, request )

Returns a list of available paper bins.

pPaperSizes ( )

Returns a list of paper sizes.

pSetDefPrt ( printer-name )

Set default printer.

pSetDefPrtEx ( printer-name, printer-driver, printer-port )

Set default printer ( extended ) .

pSetPrtAttrib ( attribute, value )

Set printer attribute.

pSetPrtInfo ( printer-name, request, value )

Sets information about a printer.

pSetPublish ( printer-name, action-flag )

Publish a printer's data in the directory service (DS), or to update or remove a printer's published data from the DS.

pVersionInfo ( request )

Returns information on this extender.


Process Extender: WWPRC44I.DLL

Extender download [ wwprc44i.zip ]

The Process Extender allows near-complete access to processes various applications. It also includes performance monitoring functions.

Each function has a complete running example to show its usage.

To access the functions in this extender, add the following to your script:

AddExtender('WWPRC44I.DLL')

 

System Requirements:

  • WinBatch version 2004B or newer.

  • PDH.DLL

Note: If the PDH.DLL file doesn't exist on your system, you will receive the error 230: Could not load PDH.DLL. We have provided an older version of this dll in the Extenders\Process subdirectory on your WinBatch CD-ROM. The file name is: PDH.OLD-DLL. If necessary, rename that dll to PDH.DLL and distribute it with the script.

 

tBrowseCntrs ( format-flag, type-flag, reserved, reserved, reserved )

Dialog to obtain performance counter string or used for data retrieval. {NT only}

tCloseProc ( process-handle )

Close an open process handle.{95/98 & NT}

tCompatible ( )

Determines if running on proper platform to run any of the functions

available in this extender.{95/98 & NT}

tCountProc ( )

Retrieves the number of currently running processes. {95/98 & NT}

tGetData ( counter-string, type-flag )

Returns the current value of a specified performance counter, in the format requested. {NT only}

tGetLastError ( )

Returns the error number for an error that may have occurred on the previous call.{95/98 & NT}

tGetModInfo ( process-id, module-handle )

Retrieves information about a module.{NT only}

tGetPriority ( process-id )

Gets priority class of a process.

tGetProcInfo ( process-id )

Retrieves information about the memory usage of the specified process id.{NT only}

tKillProc ( process-id )

Terminate a process.{95/98 & NT}

tListMod ( process-id, flag )

Gets a list modules of a particular running process. {95/98 & NT}

tListProc ( )

Gets a list of all running processes. {95/98 & NT}

tOpenProc ( process-id, access-flag )

Open process, gets process handle.{95/98 & NT}

tParseCntrPath ( counter-string )

Parses elements of the counter path. {NT only}

 

tRemoteConn ( machine-name )

Establishes a connection to a remote machine, for performance monitoring.{NT only}

tSetPriority ( process-id, priority-class )

Sets priority class of a process.

tVersion ( )

Get version number of process extender DLL.{95/98 & NT}


Ras Extender: WWRAS44I.DLL

Extender download [ wwras44i.zip ]

The Ras Extender allows you to manage remote access connections, and manipulate phone-book entries.

Remote Access Service (RAS) provides remote access capabilities to client applications on computers using Microsoft® Windows® 95 or later and Windows NT® version 4.0 and later, including Windows 2000, operating systems. RAS applications can perform the following tasks:

  • Start and end a RAS connection operations

  • Create, edit, or copy phone-book entries

  • Get RAS information, including information about existing RAS connections, and notifications when a RAS connection begins or ends.

To access the functions in this extender, add the following to your script:

AddExtender('WWRAS44I.DLL')

 

System Requirements:

  • WinBatch version 2004B or newer.

  • Ras / Dial-Up-Networking is installed

  • Windows 95 OSR 2 or later

 

RasConStatus ( connection handle )

Checks status of connection.

RasCopy ( entryname, new-entryname)

Create a copy of a phonebook entry.

RasDial ( entryname, phone-number, username, pswd, reserved )

Dials an existing entry in the default phone book.

RasEntryAdd ( entryname, username, password, reserved, reserved )

Create a new entry or edit an existing entry.

RasEntryDel ( entryname )

Deletes an entry from the default phone book.

RasEntryExist ( entryname )

Determines whether an entryname already exists in the default phone book.

RasEntryInfo ( entryname, element )

Retrieves parameter ( element ) information for an existing entry.

RasEntrySet ( element, value )

Modifies parameter information for an entry.

RasGetConStat ( connection-handle, request-flag )

Retrieves connection statistics for the specified connection.

RasGetLastErr ( )

Returns the RAS error number for an error that may have occurred on the previous call.

RasHangUp ( connection-handle )

Hangs up an active connection.

RasInstalled ( )

Checks if RAS DLL is installed.

RasItemize ( )

Returns a list of entries contained in the current default phone book.

RasListActCon ( )

Lists active RAS connections, and connection handles.

RasNameValid ( entryname )

Validates the format of a connection entry name.

RasNumCons ( )

Returns the number of active RAS connections.

RasRename ( entryname, new-entryname )

Rename an existing phonebook entry.

RasTypeSize ( )

This functions returns the size of the RASENTRY structure.

 

RasVersion ( )

Returns the version number of the RAS extender DLL.


Reggie Extender: WWREG34I.DLL

Extender download [ wwreg34i.zip ]

The Registry Searcher Extender (aka Reggie) allows you to search the Windows Registry at warp speed. Much faster than RegEdit.

Having said that, we want to extend the following disclaimer and warning regarding Reggie: Utilize it with great care and caution!!! Depending upon how the search is formulated, Reggie may find items you don't expect to find. Therefore, use the results judiciously, especially in the case of cloning or moving around parts of the registry!!

It is recommended that extensive testing be required and carried out before you do anything with this extender, since the potential exists for destroying thousands of systems when manipulating their registries. Check carefully what you get back!

In using this extender, you agree to take on all the risks, and Wilson WindowWare relinquishes any responsibility for registry corruption. We are not responsible for anything at all. Nothing. Even if we are held responsible, the limit of our liability is the licensing fees you paid. The full text of our license agreement and disclaimer is found in the "Read Me Now.txt" file, in your ..\WinBatch folder.

To access the functions in this extender, add the following to your script:

AddExtender('WWREG34I.DLL')

 

System Requirements: WinBatch version 2001A or newer.

 

rRegSearch ( startkey, keystring,l ookfor, looktype, lookat, dosubtree )

The rRegSearch function can search through the registry and return all locations where a key or value is located.

rRegVersion ( )

Returns the DLL version number.


Serial Extender: WWSER44I.DLL

Extender download [ wwser44i.zip ]

The Serial Communications Extender allows WIL scripts to communicate with standard or USB serial ports and to devices (such as modems, lab equipment, other computers, serial terminals, serial printers, X-10 home controllers and digital cameras) connected to those ports.

The extender has built in modem support to communicate with most standard modems. It also supports a few file transfer methods such as Zmodem.

To access the functions in this extender, add the following to your script:

AddExtender('WWSER44I.DLL')

 

System Requirements: WinBatch version 2004B or newer.

 

pCaptureLog ( text )

Write a line of text to the capture file if capture is enabled.

pCaptureOff ( )   

Turns off port data capture.

pCaptureOn ( filename, type )

Enables port data capture.

pCheckBinary ( lpaddr, count, type )

Performs a checksum computation on a string value.

pCheckSum ( string, type )

Performs a checksum computation on a string value.

pComClose ( port, timeout )

Closes the serial port.

pComControl ( port, request, val3, val4, val5 )

Sets assorted control values for the serial connection.

pComInfo ( port, request )

Returns infomation or status on the specified serial port.

pComOpen ( port, rsvd, baud, format, handshake )

Opens a serial COM port for use.

pGetBinary ( port, lpaddr, count )

Reads characters from the input buffer to a memory address ( usually a WIL Binary buffer ) .

pGetByte ( port )

Gets a character from the input buffer. Returns result as an Ascii code.

pGetChar ( port )

Gets a character from the input buffer. Returns result as a character.

pGetLastError ( type )

Returns number and description of results of previous operation.

pGetLine ( port, max )

Read a line of data from the input buffer.

pGetString ( port, count )

Reads specified number of characters from the input buffer.

pModemAnsCall ( port, ringcount, mode )

Waits for a call from a remote modem, connects to the remote modem and returns when connected.

pModemAnsRing ( port, ringcount, timeout )

Waits for a RING signal from the modem. Does not answer the call. Modem remains in command state.

pModemCommand ( port, command )

Sends an AT command to the modem. The AT of the command is not required.

pModemConnect ( port )

Checks or waits for a connection to a remote modem.

pModemControl ( port, request, parameter )

Control modem activity.

pModemDial ( port, mode, number )

Dials a telephone number.

pModemHangup ( port )

Hangs the modem up.

pModemInit ( port )

Initializes the modem.

pModemParams ( port, getset, request, value )

Gets or sets various modem parameters.

pModemSReg ( port, getset, register, value )

Gets or sets a modem S register.

pPeekByte ( port )

Examines the input buffer for a character. Returns result as an Ascii code.

pPeekChar ( port )

Examines the input buffer for a character. Returns result as a character.

pPutBinary ( port, lpaddr, count )

Writes characters from a memory address ( usually a WIL Binary buffer ) to the output buffer.

p style="font-weight: bold;">pPutByte ( port, byte )

Write an Ascii code to the output buffer.

pPutChar ( port, char )

Write a character to the output buffer.

pPutLine ( port, string )

Write a string of characters to the output buffer and appends a Carriage Return character.

pPutString ( port, string )

Writes a string of characters to the output buffer.

pRecvFile ( port, protocol, path, overwrite, progress )

Instructs the serial extender to receive a file.

pSendFile ( port, protocol, path, reserved, progressdialog )

Instructs the serial extender to send a file.

pTimeout ( port, time )

Sets timeout for i/o operations.

pWaitFor ( port, waitstringlist, delimiter, keepdiscard, timeout )

Waits for one or more strings to be be received.


ShellOp Extender: WWSOP34I.DLL

Extender download [ wwsop34i.zip ]

This Shell Operations extender adds certain additional file operation capabilities to the Windows Interface Language (WIL) processing engine.

To use the ShellOp Extender, you need both the SHFOLDER.DLL and WWSOP34I.DLL files, which are distributed with this extender.

To access the functions in this extender, add the following to your script:

AddExtender('WWSOP34I.DLL')

 

System Requirements:

  • WinBatch version 2001A or newer.

  • SHFOLDER.DLL

 

aFileCopy ( source-file, target-directory, flags )

Performs a filecopy

 

aFileDelete ( source-file, flags )

Performs a file delete

 

aFileMove (s ource-file, target-directory, flags )

Moves files

aFileRename ( source-file, target-directory, flags )

Renames files

aGetLastError ( )

Returns the extender error number for an error that may have occurred on the previous

call to a function

aMsgTimeout ( seconds, title, text, left-pushbutton-text, right-pushbutton-text )

Creates a message-type box with title, text, two pushbuttons and timeout thermometer bar.

This function will place a message box on the screen. If no user response is received by the

specified time, the box will be closed and execution will continue.

aStatusBar ( request-code, title, text, max-range, current-position )

Creates a simple "progress-inidicator / thermometer bar" with title, text, and the progress indicator.

aShellFolder ( request-code, value )

Returns the path to the desired folder.

aVersion ( request# )

Returns the version number


SQLite Extender: ILCSL44I.DLL/ILCSL64I.DLL

Extender download [ ilcsl44i.zip ]   

The SQLite extender allows WIL scripts to create and access SQLite databases.

To access the functions in this extender, add the following to your script:

AddExtender('ILCSL44I.DLL',0,'ILCSL44I.DLL')

 

System Requirements:

  • The SQLite extender requires Windows Vista/2008 or newer.

  • WinBatch 2005C or newer is required to use this version of the SQLite extender.

  • 32-bit WinBatch version 2005C or newer.

  • 64-bit WinBatch version 2011B or newer.

slClose ( [object-handle] )

Releases all resources associated with a database or statement or resources associated with all open databases and statements.

slConnect ( database-URI )

Returns a database object handle for a new or existing database from a file or in-memory.

slExecute ( database-handle, SQL-statements[, options ] )

Executes one or more text SQL statements and optionally returns the results as a rank 2 array.

slGetInfo ( option )

Retrieves the extender version and other information about the extender.

slSerialize ( database-handle, file-name[, schema-name] )

Saves the serialization of a database to a new or existing file.

slStatement ( database-handle, SQL-statement [, placeholder-values ])

Compiles an SQL statement with optional placeholder values and returns a statement handle.

slStmExec ( statement-handle[, &row[, options]] )

Executes a compiled SQL statement and optionally returning one row of any results in a WIL variable with each call to the function.

slStmExecAll ( statement-handle[, options] )

Executes a compiled SQL statement and returns the results as a rank 2 or optionally rank 1 WIL array.

slStmExecMany ( statement-handle, placeholder-values[, first-row[, row-count]])

Executes a compiled SQL statement using one or more supplied placeholder values from the supplied WIL map or array.

slStmReset (statement-handle[, placeholder-values] )

Returns a compiled SQL statement to the begin query state and optionally adds new placeholder values.


Terminal Services Extender: WWWTS44I.DLL/WWWTS64I.DLL

Extender download [ wwwts44i.zip ]

This extender allows a WinBatch script to directly enumerate, interrogate and manipulate terminal services sessions on a WinNT/2K/XP system that has terminal services enabled on it. This functionality also works on a system that is running the Citrix MetaFrame and MetaFrame/XP software, although the extender does not have the ability to take advantage of any Citrix-specific functionality enhancements. Additional Citrix-related enhancements will be made to this extender in future release of this extender.

This extender cannot be used by a script that is not running on system with terminal services enabled. In that situation [e.g. running on a regular WinNT system or a Win2K system without terminal services installed], the extender will load but its functionality will be reduced to where all it can do is to return the extender version and allow the user to safely query the system as to whether or not the extender has detected terminal services. This means that all scripts can load the extender [on the NT platform family], but it is necessary to call the function wtsIsTSEnabled() in order to determine if it is safe to call any other functions in the extender [except for wtsVersion() - this is safe all of the time]. However, it is permissible to copy the WTSAPI32.DLL file from another Win2K server system that has terminal services enabled on it and place the file in the "%windir%\system32" directory on the workstation. The server system from which the file is copied should match the workstation's version and service pack level to ensure that it is compatible with the workstation. When this has been done, it is possible for the WTS extender to load and function normally on a workstation that does not otherwise have terminal services enabled on it. The workstation may then be used to perform remote administration of other terminal server systems on the network. This is not an issue on WinXP [and newer] as terminal services are built into WinXP [and newer] as a standard feature. In the case of a WinNT v4.0 Workstation system, multiple files need to be copied to "%windir%\system32" from a WinNT v4.0 Terminal Server Edition server in order for the WTS* API functions to be usable from a regular workstation. The list of files is WTSAPI32.DLL, UTILDLL.DLL, WINSTA.DLL and REGAPI.DLL. A final note regarding WinNT v4.0 Workstation, if the specified files are copied onto the workstation, the WTS extender will work except for the function wtsProcIdToSessId(), which will raise an error if it is called in that configuration.

To access the functions in this extender, add the following to your script:

AddExtender('WWWTS44I.DLL',0,'WWWTS64I.DLL')

 

System Requirements:
32-bit WinBatch version 2004B or newer.
64-bit WinBatch version 2011B or newer.

 

wtsDisconnectSession ( server, session, wait-flag )

Disconnects the specified session on a terminal server system.

wtsEnumProcesses ( server [, session] )

Enumerates all of the processes that exist on the specified terminal server.

wtsGetActiveConsoleSessId ( )

Returns the session id number for the session is currently associated with the system console. This function only returns a meaningful value on WinXP systems.

wtsIsCitrixEnabled ( Request )

Determines if the system on which this extender was loaded has various Citrix-related functionality enabled.

wtsIsTSEnabled ( [Request] )

Determines if the system on which this extender was loaded has terminal services enabled.

wtsLastErrMsg ( error_code )

Returns an error message string.

wtsLogoffSession ( server, session, wait-flag )

Performs a logoff of the specified session on a terminal server system.

wtsProcIdToSessId ( pid )

Obtains the session # that is associated with a process id value in a terminal server environment.

wtsQuerySessionInfo ( server, session )

Obtains information for a specified session on a specified terminal server.

wtsSendMessage ( server, session, title, message, style, timeout, wait-flag )

Sends a message to the windowstation & active desktop for the specified session.

wtsShutdownSystem ( server, flag )

Shuts down a terminal server system.

wtsTerminateProcess ( server, process, exit-code )

Terminates a single process on a terminal server system.

wtsVersion ( [request] )

Returns the Windows Terminal Server Extender version number.

wtsWaitSystemEvent ( server, event-mask )

Waits for one or more terminal services related events to occur.


WILX Extender: WILX44I.DLL/WILX64I.DLL

Extender download [ wilx44i.zip ]

This Extender provides additional capability to the Windows Interface Language and is a good example of the useful things you as a developer can create using the Extender SDK.

To access the functions in this extender, add the following to your script:

AddExtender('WILX44I.DLL',0,'WILX64I.DLL')

 

System Requirements:
32-bit WinBatch version 2004B or newer.
64-bit WinBatch version 2011B or newer.

 

xBaseConvert ( value, from-base, to-base )

Performs base conversions.

xDiskLabelGet ( drive )

Returns volume label of specified drive.

xDriveReady ( drive )

Checks whether the drive is ready.

xEjectMedia ( drive )

Ejects media from removable drives.

xEnumStreams ( filename, flags )

Enumerates named streams in a file. (Windows NT/2000/XP only)

xExtenderInfo ( request# )

Returns information on this extender.

xGetChildHwnd ( parent-hwnd, child-text, child-seq )

Gets the handle of a child window belong to the specified parent.

xGetElapsed ( time1, time2 )

Calculates difference between two values obtained with GetExactTime ( ) .

xHex ( hex-val )

Converts from hex to decimal.

xMessageBox ( title, text, style )

The "real" MessageBox function.

xSendMessage ( hWnd, msg, wparam, lparam )

The real SendMessage.

xVerifyCCard ( cardnum )

Verifies the validity of a credit card number.


Win32 Network Extender: WWWNT34I.DLL/WWWNT64I.DLL

Extender download [ wwnet34i.zip ]

The Windows 32 Network extender provides standard support for computers running Windows NT, 2000, XP, 2003 and Vista

For use on Windows NT, 2000, XP, 2003 and Vista workstations and can control Windows NT, 2000, XP, 2003 and Vista servers.

To access the functions in this extender, add the following to your script:

AddExtender('WWWNT34I.DLL',0,'WWWNT64I.DLL')

System Requirements:
32-bit WinBatch version 2001A or newer.
64-bit WinBatch version 2011B or newer.

 

wntAccessAdd ( server-name, resource/share-name, account-name, object-type, access-string [, flags] )

Adds or updates access (permission) records for a resource.

wntAccessDel ( server-name, resource/share-name, account-name, object-type [, flags] )

Deletes access (permission) records for a resource.

wntAccessGet ( server-name, resource/share-name, account-name, object-type [, flags] )

Returns Discretionary Access Control List [DACL, a.k.a. permission] records for a resource.

wntAccessList ( server-name, resource/share-name, object-type, flags )

Returns list of users who have Discretionary Access Control List [DACL, a.k.a. permission] records for a resource.

wntAccessMod ( server-name, resource-name, object-type, request, flags )

Modifies the Discretionary Access Control List [DACL] inheritance flags. The DACL is what is commonly referred to as the "permissions" on an object.

wntAcctInfo ( server-name, account-name, request [, flags] )

Returns information about an account [e.g. a user or group] or a SID [e.g. Security Identifier].

wntAcctList ( server-name , request [, output-format-flag] )

Rapidly lists accounts.

wntAcctPolGet ( server-name, request )

Gets account policy information for a server.

wntAcctPolSet ( server-name, request, value )

Sets account policy information for a server.

wntAddDrive ( user-id, pswd, net-resource, local drive, persist )

Maps a drive.

wntAddPrinter ( user-id, pswd, net-resource, local device, persist )

Maps a printer resource to a local port.

wntAuditAdd ( server-name, resource/share-name, account-name, object-type, access-string [, flags] )

Adds or updates System Access Control List [SACL, a.k.a. audit] records for a resource.

wntAuditDel ( server-name, resource/share-name, account-name, object-type [, flags] )

Deletes System Access Control List [SACL, a.k.a. audit] records for a resource.

wntAuditGet ( server-name, resource/share-name, account-name, object-type [, flags] )

Returns System Access Control List [SACL, a.k.a. audit] records for a resource.

wntAuditList ( server-name, resource/share-name, object-type, flags )

Returns list of users who have System Access Control List [SACL, a.k.a. audit] records for a resource.

wntAuditMod ( server-name, resource-name, object-type, request, flags )

Modifies the System Access Control List [SACL] inheritance flags. the SACL is what is commonly referred to as the "auditing" on an object.

wntCancelCon ( local drive, persist, forceflag )

Breaks a network connection.

wntChgPswd ( server/domain, user-name, old-password, new-password )

Changes a user's password.

wntCurrUsers ( server-name, flags )

Lists users currently logged into a server.

wntDfsGetInfo ( DFS Path )

Gets information about a specific DFS links.

wntDfsList ( DFS name )

Lists all of the DFS links under a DFS root that is hosted by a particular storage server or domain.

wntDirDialog ( flag )

Brings up a network drive connect/disconnect dialog box

wntDomainSync ( server-name, request )

Synchronizes domain controllers.

wntEventLog ( server-name, text )

Writes a "WBMSG" entry to the NT application event log.

wntEventWrite ( server-name, source-name, type/category, event-id, description )

Writes an entry to an NT event log.

wntFileClose ( server-name, file-pathname )

Close all network connections to a file.

wntFilesOpen ( server-name )

Lists open files on a server.

wntFileUsers ( server-name, file-pathname )

Lists network users who have a file open.

wntGetCon ( local drive )

Returns the name of a connected network resource.

wntGetDc ( server-name, domain-name, flag )

Returns the domain controller for a domain.

wntGetDrive ( net-resource )

Lists local drives mapped to a UNC.

wntGetUser ( netname )

Returns the name of the user currently logged into the network.

wntGroupAdd ( server-name, group-name, group-type, comment )

Creates a user group.

wntGroupDel ( server-name, group-name, group-type [, input-format-flag ] )

Deletes a user group.

wntGroupEdit ( server-name, group, group-type, request, value [, input-format-flag ] )

Modifies information about a group.

wntGroupInfo ( server-name, group, group-type, request [, output-format-flag [, input-format-flag ] ] )

Returns information about a group.

wntGroupRen (server-name, group, group-type, new-name [, input-format-flag ] )

Renames a group.

wntLastErrMsg ( error-number )

Retrieves error message text associated with an error code from this extender.

wntListGroups ( server-name, group-type [, output-format-flag ] )

Returns tab-delimited list of all user groups on a specified server.

wntLsaPolGet ( server-name, class, element )

Gets LSA (Local Security Authority) policy information.

wntLsaPolSet ( server-name, class, element, value )

Sets LSA (Local Security Authority) policy information.

wntMemberDel ( server-name, group-name, user-name, group-type [, input-format-flag ] )

Deletes the specified user from the specified group on the specified server.

wntMemberGet ( server-name, group-name, user-name, group-type [, input-format-flag ] )

Determines if the specified user is a member of the specified group on the specified server.

wntMemberGrps ( server-name, user-name, group-type, flags [, output-format-flags [, input-format-flags ] ] )

Returns a list of groups to which the specified user belongs.

wntMemberList ( server-name, group-name, group-type [, output-format-flag [, input-format-flag ] ] )

Returns a list of the members of a user group.

wntMemberSet ( server-name, group-name, user-name or group-name, group-type [, input-format-flag ] )

Sets the specified user/ or group as a member of the specified group on the specified server.

wntOwnerGet ( server-name, reg-key, resource-name, object-type, flags)

Returns the owner of an object.

wntOwnerSet ( server-name, reg-key, resource-name, object-type, account-name [, flags ] )

Takes/sets ownership of an object.

wntPrivAdd ( server-name, user/group name, privilege [, input-format-flag ] )

Grants a privilege to a user or group.

wntPrivDel ( server-name, user/group name, privilege [, input-format-flag ] )

Removes a privilege from a user or group.

wntPrivGet ( server-name, user/group name, privilege [,input-format-flag ] )

Determines whether a user or group holds a privilege.

wntPrivList ( server-name, user/group name [,input-format-flag ] )

Returns a list of priviliges granted to a user or group.

wntPrivUsers ( server-name, privilege [, output-format-flag ] )

Returns a list of users and groups [or SID values] that have been granted the specified privilege.

wntProfileDel ( server-name , SID-string [, profile path] )

Deletes a profile from the system. (Windows 2000 or newer

wntProfileInfo ( request )

Gets information about a profile on the local system.

wntRasUserGet ( server-name, user-name, request [, input-format-flag ] )

Gets RAS information for a user.

wntRasUserSet ( server-name, user-name, privilege, phone-number [, input-format-flag ] )

Sets RAS information for a user.

wntRemoteTime ( server-name, format )

Gets the time of day from a server.

wntResources ( net-resource, scope, type, usage )

Itemizes network resources.

wntResources2 ( net-resource, scope, type, usage, provider )

Itemizes network resources.

wntRunAsUser ( domain/server, user-name, password, login-type, flags )

Run as a different user. (Requires NT 4.0 or newer)

wntSecurityGet ( server-name, resource, object-type, request, flags )

Returns security information about an object.

wntServerInfo ( server-name, request )

Returns information about a server.

wntServerList ( server-name, domain-name, server-type )

Lists servers in a domain.

wntServerType ( server-name )

Returns a server's platform.

wntServiceAt ( server, domain, server-type, service-name, flags [, display-flag ] )

Lists all servers in a domain which contain a specified service.

wntServiceInf ( server-name )

Returns information about a server's type.

wntShareAdd ( server-name, resource, share-name,share-type, max-users )

Shares a resource.

wntShareDel ( server-name, resource/share-name, share-type )

UN-shares a resource.

wntShareinfo ( server-name, resource/share-name, share-type, request )

Returns information about a shared resource.

wntShareList ( server-name, share-type, flags )

Returns a list of shares on a server.

wntShareSet ( server-name, resource/share-name, share-type, comment, description

Sets additional share information for a resource.

wntShareUsers ( server-name, share/computer-name, share-type, format, flags )

Returns a list of users connected to a share or server.

wntShutdown ( computer-name, message, timeout, force, reboot )

Shuts down (and optionally restarts) a computer.

wntSvcCfgGet ( server, service-name, flags, request )

Gets a configuration parameter for a service.

wntSvcCfgSet ( server, service-name, flags, request, value )

Changes a configuration parameter for a service.

wntSvcControl ( server, service-name, flags, control-code )

Stops or controls a service.

wntSvcCreate ( server-name, string-values, numeric-values, dependencies, reserved )

Adds a service to the service control manager database.

wntSvcDelete ( server, service-name, flags )

Marks a service for deletion from the service control manager database.

wntSvcList ( server-name, service/group-name, flags )

Return lists of service names that meet the specified search criteria.

wntSvcStart ( server, service-name, flags, params, delimiter )

Starts a service.

wntSvcStatus ( server, service-name, flags, request )

Returns status information on a service.

wntUserAdd ( server-name )

Adds a user account.

wntUserAddDat ( element, value )

Sets parameter information for wntUserAdd. (This function sets values for elements in a user parameter structure, which is used by the wntUserAdd function.)

wntUserDel ( server-name, user-name [, input-format-flag ] )

Deletes a user account.

wntUserExist ( server-name, user-name [, input-format-flag ] )

Determines whether a user exists.

wntUserGetDat ( server-name, user-name, element [, input-format-flag ] )

Returns parameter information for a user account.

wntUserInfo ( request)

Returns information about the currently logged-on user.

wntUserList ( server-name, account-type [, output-format-flag ] )

Lists users with accounts on an NT server.

wntUserProps (server-name, user-name, request [, input-format-flag ] )

Returns information about a network user.

wntUserRename (server-name, old-username, new-username [, input-format-flag ] )

Renames a user account.

wntUserSetDat (server-name, user-name, element, value [, input-format-flag ] )

Modifies parameter information for a user account.

wntUserSidChk ( request, SID, reserved-1, reserved-2, reserved-3 )

Checks SID's in an access token.

wntVersion ( )

Returns the version of this Extender DLL.

wntWtsUserGet ( server-name, user-name, request [, input-format-flag ] )

Gets user information from an NT Terminal Server. This function requires WTSAPI32.DLL to be present.

wntWtsUserSet ( server-name, user-name, request, value [, input-format-flag ] )

Modifies user information on an NT Terminal Server.


WinInet Extender: WWINT44I.DLL/WWINT64I.DLL

Extender download [ wwint44i.zip ]

The Internet Extender contains a slew of functions which allow communication between host computers, Internet Service Providers and supported networks for Windows operating systems.

To access the functions in this extender, add the following to your script:

AddExtender('WWINT44I.DLL',0,'WWINT64I.DLL')

 

System Requirements:
32-bit WinBatch version 2004B or newer.
64-bit WinBatch version 2011B or newer.

Note: If running Windows 95, or NT 4.0, support for this extender can be added by installing MSIE 4.0 or newer. It does NOT need to be your default browser. You can download free copies from Microsoft.

 

iAddr2Host ( host address, timeout )

Converts a host address into an host name.

iBegin ( accesstype, proxyname, proxybypass )

This function allocates and defines a top level handle for other internet functions. It allows you to define the connect type and proxies. It also allows for a pre-configured connect via various registry entries. Notably the same ones used by MSIE. Close this handle with iClose before exiting the script.

iClose ( tophandle )

This function will close a handle and associated subhandles

iContentData ( bbaddr, endofcontent, name, value )

Formats a simple variable into multipart/form-data in a BinaryBuffer for a POST-type HTTP request.

iContentFile ( bbaddr, endofcontent, name, localfile, MIME-type )

Formats the contents of a file into multipart/form-data in a BinaryBuffer for a POST-type HTTP request.

iContentUrl( url-data, keyword, value )

Formats a simple variable into an encoded URL for a POST-type HTTP request.

iCookieGet ( ur )

Retrieves cookies for the specified URL and all its parent URLs.

iCookieSet ( url, cookie-name,cookie- data )

Sets a cookie on the specified URL.

iDial ( dial-up name, password )

Dials up and connects to an Internet host, bypassing the Connect to dialog box.

iDialHangUp ( connection )

Disconnects a specified dial-up Internet connection, or all existing connections, from an Internet host.

iDialItemize ( )

Creates a list of all the valid Dial-Up Networking hosts. These are the ones the user normally chooses from when they connect to the Internet via the Connect To dialog.

iErrorDialog ( handle, error )

Displays a dialog box for the error that is passed to iErrorDialog, if an appropriate dialog box exists.

iFtpCmd ( connect-handle, command, command-parameters, transfer mode )

Send commands directly to an FTP server. This function requires Internet Explorer 5.x or newer.

iFtpDelete ( connect-handle, filename )

Deletes specified file on the ftp server.

iFtpDialog ( option, title, text, progress, cancel-flag )

Retrieves the file size of the requested FTP resource.

iFtpDirChange ( connect-handle, directory )

Changes to a different working directory on the FTP server.

iFtpDirGet ( connect-handle )

Retrieves the current directory for the specified FTP session.

iFtpDirMake ( connect-handle, directory )

Creates specified directory on the ftp server.

iFtpDirRemove ( connect-handle, directory )

Removes specified directory on the ftp server.

iFtpFileSize ( connect-handle, filename )

Removes specified directory on the ftp server.

iFtpFindInit ( connect-handle, directory, filename mask, recurse,match-case )

Returns a search handle to be used by the iFtpFindNext.

iFtpFindNext( extended-info )

Finds the next file. (For use with iFtpFindInit)

iFtpGet ( connect-handle, remotefile, localfile, file-size, file-flag [,keep-alive ] )

Retrieves a file from the FTP server and stores it under the specified file name,creating a new local file in the process.

iFtpOpen ( connect-handle, filename, access, flag )

Initiates access to a remote file for reading or writing.

iFtpPut ( connect-handle, local-filename, remote-filename,file-size, file-flag [, keep-alive ] )

Stores a local file on the FTP server.

iFtpRename ( connect-handle, source-filename, target-filename )

Renames a file on the ftp server.

iGetConState( request )

Retrieves the connected state of the local system.

iGetConStatEx( request )

Retrieves the connected state of the local system. However, this extended function requires Internet Explorer 5.x or newer.

iGetIEVer ( )

Returns Internet Explorer's version string

iGetLastError ( )

Returns the WININET error number for an error that may have occurred on the previous call to an iFunction.

iGetResponse ( )

Retrieves the last Win32 Internet function error description or server response.

iHost2Addr( host name, timeout )

Converts a host name into a host address.

iHostConnect ( top-handle, host, service, userid, pswd )

This function connects to an Internet host.

iHttpAccept ( accept strings )

Specify HTTP accept data type.

iHttpHeaders ( data-handle )

Obtains the response headers received from an iHttpOpen request.

iHttpInit ( connect-handle, verb, object, referrer, flags )

Initializes a datahandle and sets up - but does not actually perform - an Http request.

iHttpOpen ( data-handle, headers, bbaddr / url-data, data-length / flag )

Completes an HTTP request and actually sends it to the server.

iLocFindInit ( directory, filename/ mask, recurse )

Initiates a file search on a local machine. Returns a search handle to be used by the iLocFindNext.

iLocFindNext ( extended info )

Finds the next file on the local machine.

iOptionGet ( handle, optionname )

Retrieves various bits of information from the WININET DLL.

iOptionSet ( handle, optionname, newvalue )

Sets various parameters in the WinInet DLL

iPing ( hostname/address, timeout )

Determines if the specified host is responding.

iParseUrl ( url, flag, request )

Breaks a URL into its component parts.

iReadData ( data-handle, localfile )

This function transfers data from an internet host to a data file.

iReadDataBuf ( data-handle, bbaddr, bbsize )

Transfers data from an internet host to a binary buffer.

iUrlDecode ( data )

Takes a string in URL encoded format and converts it to plain text.

iUrlEncode ( data )

Takes a plain text string and converts it to URL encoded format.

iUrlOpen ( top-handle, url )

This is a simple function that can set up a standard data download of HTTP, HTTPS, FTP and GOPHER functions. There are no options.

iVersion ( )

Returns the version number of the extender DLL.

iWriteData ( data-handle, filename )

Writes a local file to an ftp server.

iWriteDataBuf ( data-handle, bbaddr, bbsize )

Transfers data from a binary buffer to an internet host.


WinSock Extender: WWWSK44I.DLL/WWWSK64I.DLL

Extender download [ wwwsk44i.zip ]

The WinSock Internet Extender contains a slew of functions which allow communication between host computers, Internet Service Providers and supported networks for Windows 95 and Windows NT operating systems. These functions include high level operations (including ftp, http, smtp, pop3, and ping) as well as low level operations consisting of various direct WinSock calls.

The WinSock Internet Extender can…

  • Communicate over any TCP/IP supported network with the socket functions.

  • Connect to an Internet Service Provider with the Dial-Up Networking (DUN) functions.

  • Use the HTTP functions to request files from a web server.

  • Transfer files from a remote host computer with the FTP family of functions.

  • Check the mailbox for incoming Internet mail via the POP3 functions.

  • Send outgoing mail with Simple Mail Transport Protocol (SMTP).

To access the functions in this extender, add the following to your script:

AddExtender('WWWSK44I.DLL',0,'WWWSK64I.DLL')

System Requirements:
32-bit WinBatch version 2004B or newer.
64-bit WinBatch version 2011B or newer.

dunConnect ( dial-up name )

Dials up and connects to an Internet host, using existing password bypassing the Connect to dialog box

dunConnectEx ( dial-up name, password )

Dials up and connects to an Internet host, using a supplied password, bypassing the Connect to dialog box

dunDisconnect ( connection )

Hangs up a specified dial-up Internet connection, or all existing connections.

dunItemize ( )

Creates a list of all the valid Dial-Up Networking hosts. These are the ones the user normally chooses from when they connect to the Internet via the Connect To” dialog.

ftpOpen ( host name, username, password, account, attempts )

Opens an FTP session on a remote host.

ftpClose ( hSession )

Closes an FTP session

ftpGet ( hSession, remote-file, local-file, transfer-type )

Copies a file from a remote FTP server to the local machine.

ftpFirewall ( type,host, port, user-id, password )

Sets up FTP to use a proxy/firewall server.

ftpPut ( hSession, local-file, remote-file, transfer-type )

Sends a file from the local machine to a remote FTP server.

ftpList ( hSession, remote-path, local-file )

Obtains a directory listing from a remote FTP server.

ftpChDir ( hSession, remote-path )

Changes the current directory on a remote FTP server.

ftpQuote ( hSession, command )

Sends a command string to a remote FTP server.

ftpRename ( hSession, remote-oldname, remote-newname )

Renames a file on a remote FTP server.

ftpDelete ( hSession, remote-file )

Deletes a file from a remote FTP server.

httpAuth ( user-ID, password )

Sets Access Authorizations for subsequent HTTP receive functions

httpFirewall ( type, host, port, user id, password )

Sets up Http to use a proxy/firewall server

httpFullPath ( path, defServer, defDir, defFile, defAnchor )

This builds a fully-qualified HTTP url from a given url. You can give it 4 defaults for the various parts.

httpGetAnchor ( URL, anchor )

Extracts the anchor name from an HTTP URL.

httpGetDir ( URL, dirpath )

Extracts the full directory path from an HTTP URL.

httpGetFile ( URL, filename )

Extracts the filename from an HTTP URL.

httpGetPath ( URL, dirpath )

Extracts the file’s full pathname from an HTTP URL.

httpGetQuery ( URL, query string, maxsize )

Extracts a CGI query string from an HTTP URL.

httpGetServer ( URL, domain name )

Extracts the server’s domain name from an HTTP URL.

httpRecvFile ( server, path, localfile, flag )

Downloads a web page or image directly to a file.

httpRecvQryF ( server, path, query, localfile, flags )

Sends a "POST" or "GET" request to a CGI program on a web server and puts the response into a file

httpRecvQuery ( server, path, query, maxsize, flags )

Sends a "POST" or "GET" request to a CGI program on a web server and returns the response.

httpRecvText ( server, path, maxsize, flag )

Downloads a text file from a web server.

httpRecvTextF ( server, path, localfile, flag )

Downloads a text file from a web server, and it ensures the file it writes out has carriage-return line-feeds at the end of each line.

httpStripHTML ( text )

Removes HTML embedded in a string

p3Close ( handle )

Closes a POP3 session.

p3Count ( handle )

Counts the number of messages in a mailbox.

p3Delete ( handle, message )

Deletes a message from a mailbox.

p3GetReply (   )

Returns the description from the last POP3 reply code.

p3Open ( server, user, password )

Opens a session with a POP3 mail server.

p3Peek ( handle, message, lines )

Reads the header & first few lines of a message in a mailbox.

p3RecvFile ( handle, message, filename )

Downloads a message from a mailbox directly to a file

p3RecvText ( handle, message, maxsize )

Downloads a message from a mailbox.

sAccept ( listensocket, blockflag )

Accepts a connection from a listening socket.

sByteOrder16, SByteOrder32 ( number, direction mode )

Converts a 16- or 32-bit binary number from network byte order to the PC’s byte order & vice versa.

sClose ( socket )

Closes a socket.

sConnect ( socket, hostaddr, service )

Connects a socket to an Internet host & network service ( i.e. “ftp” ) .

sListen ( listensocket, port )

Sets up a socket to listen for remote connects in order to establish a two-way TCP connection.

smtpSendFile ( server, from, to, subject, filename )

Sends a text-only file.

smtpSendText ( server, from, to, subject, text )

Sends a text-only email message.

 

sOK2Recv ( socket, size )

Checks the status of the socket to see if there is data waiting to be read.

sOK2Send ( socket )

Checks to see if data can be sent without waiting.

sOpen ( )

Creates a new stream ( TCP ) socket.

sRecvBinary ( socket, blob, size )

Gets binary data from a socket into a binary data type created with BinaryAlloc.

sRecvLine ( socket, maxsize )

Gets a line of text from a socket, up to the first CR/LF.

sRecvNum ( socket, bytecount )

Gets numeric data from a socket and converts the result from network byte order to PC byte order.

sSendBinary ( socket, blob, size )

Sends binary data to a socket.

sSendNum ( socket, number, bytecount )

Sends an integer to a socket.

sSendString ( socket, string )

sSendString sends a string to a socket.

sSendLine ( socket, string )

sSendLine will first append a CR/LF on the end of the string if it isn’t already there.

urlDecode ( data )

Takes a string in URL encoded format and converts it to plain text.

urlEncode ( data )

Takes a plain text string and converts it to URL encoded format.

urlGetScheme ( URL, scheme )

Extracts the scheme from a URL.

wxHost2Addr ( hostname )

Converts a host name into an address.

wxAddr2Host ( hostaddress )

Converts a host address into an host name.

wxGetErrDesc ( errnum )

Translates an error number to a human-readable error message

wxGetInfo ( request#, parameter )

Provides requested information

wxGetLastErr ( )

Gets the last error generated by a Internet extender function.

wxMsgGetBody ( Msg )

Extracts the body of a message from a standard Internet message.

wxMsgGetHdr ( Msg, sHeader, delimiter )

Extracts the selected header of a message from a standard Internet message.

wxMsgGetBody ( Msg )

Extracts the body of a message from a standard Internet message.

wxMsgSetHdr

Sets header values for out going HTTP requests.

wxParmGet ( request# )

Returns the value of a communication parameter used by the extender.

wxParmSet ( request#, new value )

Sets the value of communication parameters.

wxPing ( hostname/address )

Determines if a specified host is responding.

WLAN Extender: WWLAN44I.DLL/WWLAN64I.DLL

Extender download [ wwlan44i.zip ]

The Wireless LAN extender provides WinBatch scripts access to the Microsoft Windows Native Wi-Fi API. The extender's functions parallel or combine several functions in the Native Wi-Fi API but enhance and simplify usage.

Note: The Wireless LAN extender requires Windows Vista/2008 or newer for full support. The extender provides limited support on Windows XP with Service Pack 3 32-bit. Windows XP without Service Pack 3, all versions of Windows XP 64-bit, Windows 2003 and Windows 2000 are not supported by the extender.

To access the functions in this extender, add the following to your script:

AddExtender('WWLAN44I.DLL',0,'WWLAN64I.DLL')

System Requirements:

  • Windows Vista/2008 or newer.

wlAutoConfPropGet ( session-handle, property-name )

Retrieves information about the Auto Configuration Module (ACM) on the local computer.

wlAutoConfPropSet ( session-handle, property-name, property-value )

Sets Auto Configuration Module (ACM) parameters of the local computer.

wlBasicServiceSets ( session-handle, interface-guid [, network-handle ] )

Retrieves access points or peers of one or all networks available to an enabled wireless LAN interface on the local computer.

wlBssPropGet ( session-handle, interface-guid, bss-handle, property-name )

Retrieves information about Basic Service Sets associated with currently available wireless LAN networks.

wlClientClose ( session-handle )

Closes a Wi-Fi session and releases all extender resources associated with the handle.

wlClientOpen ()

Opens a client session and prepares the extender for subsequent extender function calls.

wlConnect ( session-handle, interface-guid, connection-parameters, time-out )

Connects the local computer to a destination WLAN network.

wlConParamArray ( mode, network-profile, ssid, bssid, bss-type, flags )

Retrieves an array of connection parameters to pass to the wlConnect function.

wlDisconnect ( session-handle, interface-guid )

Disconnects a network connected to a wireless LAN interface on the local computer.

wlGetInfo ( request-number )

Returns information about the Wireless LAN extender.

wlIfacePropGet ( session-handle, interface-guid, property-name )

Retrieves information about a single currently enabled wireless LAN interfaces on the local computer.

wlIfacePropSet ( session-handle, interface-guid, property-name, property-value )

Changes attributes of a single currently enabled wireless LAN interfaces on the local computer.

wlInterfaces ( session-handle )

Retrieves an array of Globally Unique Identifiers (GUID) of a wireless LAN interfaces currently enabled on the local computer.

wlNetworkPropGet ( session-handle, interface-guid, network-handle, property-name )

Retrieves information about a network currently available to a wireless LAN interface on the local computer.

wlNetworks ( session-handle, interface-guid )

Retrieves handles to networks available to a wireless LAN interface on the local computer.

wlProfileDelete ( session-handle, interface-guid, profile-name )

Deletes a profile associated with a wireless LAN interface on the local computer.

wlProfileEdit ( session-handle, interface-guid, profile-name, page-name )

Displays the local computer's a wireless network profile editing user interface (UI).

wlProfileNew ( session-handle, interface-guid, profile-xml, profile-type )

Creates a new profile for a wireless LAN interface on the local computer.

wlProfilePropGet ( session-handle, interface-guid, profile-name, property-name )

Retrieves information about profiles associated with a wireless LAN interface on the local computer.

wlProfilePropSet ( session-handle, interface-guid, profile-name, property-name, property-value )

Sets the attributes of a single profile of an enabled wireless LAN interface on the local computer.

wlProfiles ( session-handle, interface-guid )

Retrieves network profile names of profiles on a wireless interface.

wlProfileSaveTemp ( session-handle, interface-guid, profile-name, flags, overwrite )

Saves a temporary profile to the permanent profile store of a wireless LAN interface on the local computer.

wlProfilesOrder ( session-handle, interface-guid, profiles )

Change the preference order of interface profiles.

wlScan ( session-handle, interface-guid, ssid, time-out )

Requests a Wireless LAN driver scan for available wireless networks.

Zipper Extender: WWZIP44I.DLL/WWZIP64I.DLL

Extender download [ wwzip44i.zip ]

The Zip Extender allows you to zip up files and directories into zip archives, and unpack existing zip archives.

The Zip Extender can work with archives produced by PkZip, WinZip, and Windows Compressed Folders. The functions are useful for packaging a set of files for distribution; for archiving files; and for saving disk space by temporarily compressing unused files or directories.

The Zip Extender supports password encryption, for encrypting and decrypting a zip archive.

This Zip extender supports individual files of up to 2GB in size and archives greater than 10GB in size. These size limits may vary depending on your version of Windows and the file system.

To access the functions in this extender, add the following to your script:

AddExtender('WWZIP44I.DLL',0,'WWZIP64I.DLL')

System Requirements:

  • This extender no longer supports versions of Windows older than Windows 2000.

  • 32-bit WinBatch version 2004B or newer.

  • 64-bit WinBatch version 2011B or newer.

 

zUnZipFiles ( options, zip_file_name, include_files, exclude_files, target_dir [,password ] )

Extract files from a zip archive.

zVersionInfo ( 0 )

Returns the DLL version number.

zZipFiles ( options, zip_file_name, include_files, exclude_files [,password ] )

Creates a single zip archive.


Article ID:   W12347
Filename:   List of Extenders.txt
File Created: 2024:01:30:11:01:34
Last Updated: 2024:01:30:11:01:34