Win32 Extensions
NT - miscellaneous extensions for Win32.
For more information on Perl
for Win32:
- Win32mod - current set of modules for Perl for Win32
- 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.