Win32 Extensions


Perl for Win32

ActiveWare


NAME

NT - miscellaneous extensions for Win32.
For more information on Perl for Win32:

  1. Win32mod - current set of modules for Perl for Win32
  2. Win32XS - issues specific to writing module extensions for Perl for Win32 (build 1xx)

DESCRIPTION

Go here for more information on dynaloaded extension modules. Because Perl for Win32 originated on the Windows NT platform, most modules extensions for Win32 exist under the NT hierarchy. The following extensions routines are available:

Win32::GetLastError
Returns the last error value generated by a call to a Win32 API function.
Win32::OLELastError
Returns the last error value generated by a call to a Win32 OLE API function.
Win32::BuildNumber
Returns the build number of Perl for Win32.
Win32::LoginName
Returns the username of the owner of the current perl process.
Win32::NodeName
Returns the Microsoft Network node-name of the current machine.
Win32::DomainName
Returns the name of the Microsoft Network domain that the owner of the current perl process is logged into.
Win32::FsType
Returns a string naming the filesystem type of the currently active drive.
Win32::GetCwd
Returns the current active drive and directory. This function does not return a UNC path, since the functionality required to required for such a feature is not available under Windwos 95.
Win32::SetCwd NEWDIRECTORY
Sets the current active drive and directory. This function does not work with UNC paths, since the functionality required to required for such a feature is not available under Windwos 95.
Win32::GetOSVersion
Returns the array ($string, $major, $minor, $build, $id), where the elements are, respectively; An arbitrary descriptive string, the major version number of the operating system, the minor version number, the build number, and a digit indicating the actual operating system. For $id, the values are 0 for Win32s, 1 for Windows 95 and 2 for Windows NT.
Win32::FormatMessage ERRORCODE
Converts the supplied Win32 error number (e.g. returned by Win32::GetLastError or Win32::OLELastError) to a descriptive string. Analogous to the perror standard-C library function.
Win32::Spawn COMMAND, ARGS, PID
Spawns a new process using the supplied COMMAND, passing in arguments in the string ARGS. The pid of the new process is stored in PID.
Win32::LookupAccountName SYSTEM, ACCOUNT, DOMAIN, SID, SIDTYPE
Looks up ACCOUNT on SYSTEM and returns the domain name the SID and the SID type.
Win32::LookupAccountSID SYSTEM, SID, ACCOUNT, DOMAIN, SIDTYPE
Looks up SID on SYSTEM and returns the account name, domain name, and the SID type.
Win32::InitiateSystemShutdown MACHINE, MESSAGE, TIMEOUT, FORCECLOSE, REBOOT
Shutsdown the specified MACHINE, notifying users with the supplied MESSAGE, within the specified TIMEOUT interval. Forces closing of all documents without prompting the user if FORCECLOSE is true, and reboots the machine if REBOOT is true.
Win32::AbortSystemShutdown MACHINE
Aborts a shutdown on the specified MACHINE.
Win32::GetTickCount
Returns the Win32 tick count.
Win32::IsWinNT
Returns non zero if the Win32 subsystem is Windows NT.
Win32::IsWin95
Returns non zero if the Win32 subsystem is Windows 95.
Win32::ExpandEnvironmentStrings STRING
Takes the STRING and builds a return string that has environment-variable strings replaced with their defined values.
Win32::GetShortPathName LONGPATHNAME
Returns the short (8.3) path name of LONGPATHNAME.
Win32::GetNextAvailDrive
Returns a string in the form of "<d>:\" where <d> is the first available drive letter.
Win32::RegisterServer LIBRARYNAME
Loads the DLL LIBRARYNAME and calls the function DllRegisterServer.
Win32::UnregisterServer LIBRARYNAME
Loads the DLL LIBRARYNAME and calls the function DllUnregisterServer.
Win32::Sleep TIME
Pauses for TIME milliseconds.

Perl for Win32

ActiveWare