# Win32 Extensions

## 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::PerlVersion
  Returns a string indicating the version of NT Perl.
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. 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::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 generic Win32, 1 for Windows 95 and 2 for Windows NT.
Win32::FormatMessage ERRORCODE
  Converts the supplied Win32 error bitmap (e.g. returned by GetLastError) 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`.