home *** CD-ROM | disk | FTP | other *** search
/ Tutto per Internet / Internet.iso / soft95 / Html / PerlW32 / win32ext.pod < prev    next >
Encoding:
Text File  |  1996-01-31  |  2.4 KB  |  79 lines
  1. =head1 NAME
  2.  
  3. NT - miscellaneous extensions for Win32
  4.  
  5. =head1 DESCRIPTION
  6.  
  7. Because Perl for Win32 originated on the Windows NT platform, most
  8. modules extensions for Win32 exist under the NT hierarchy. The
  9. following extensions routines are available:
  10.  
  11. =item NT::GetLastError
  12.  
  13. Returns the last error value generated by a call to a Win32 API function.
  14.  
  15. =item NT::PerlVersion
  16.  
  17. Returns a string indicating the version of NT Perl.
  18.  
  19. =item NT::LoginName
  20.  
  21. Returns the username of the owner of the current perl process.
  22.  
  23. =item NT::NodeName
  24.  
  25. Returns the Microsoft Network node-name of the current machine.
  26.  
  27. =item NT::DomainName
  28.  
  29. Returns the name of the Microsoft Network domain that the owner of the
  30. current perl process is logged into.
  31.  
  32. =item NT::FsType
  33.  
  34. Returns a string naming the filesystem type of the currently active drive.
  35.  
  36. =item NT::GetCwd
  37.  
  38. Returns the current active drive. This function does not return a UNC
  39. path, since the functionality required to required for such a feature
  40. is not available under Windwos 95.
  41.  
  42. =item NT::GetOSVersion
  43.  
  44. Returns the array ($string, $major, $minor, $build, $id), where the
  45. elements are, respectively; An arbitrary descriptive string, the major
  46. version number of the operating system, the minor version number, the
  47. build number, and a digit indicating the actual operating system. For
  48. $id, the values are 0 for generic Win32, 1 for Windows 95 and 2 for
  49. Windows NT.
  50.  
  51. =item NT::FormatMessage ERRORCODE
  52.  
  53. Converts the supplied Win32 error bitmap (e.g. returned by
  54. GetLastError) to a descriptive string. Analogous to the C<perror>
  55. standard-C library function.
  56.  
  57. =item NT::Spawn COMMAND, ARGS, PID
  58.  
  59. Spawns a new process using the supplied C<COMMAND>, passing in
  60. arguments in the string C<ARGS>. The pid of the new process is
  61. stored in C<PID>.
  62.  
  63.  XXX =item NT::LookupAccountName SYSTEM, ACCOUNT, DOMAIN, SID, SIDTYPE
  64.  
  65.  XXX =item NT::LookupAccountSID SYSTEM, SID, ACCOUNT, DOMAIN, SIDTYPE
  66.  
  67. =item NT::InitiateSystemShutdown MACHINE, MESSAGE, TIMEOUT, FORCECLOSE, REBOOT
  68.  
  69. Shutsdown the specified C<MACHINE>, notifying users with the supplied
  70. C<MESSAGE>, within the specified C<TIMEOUT> interval. Forces closing
  71. of all documents without prompting the user if C<FORCECLOSE> is true,
  72. and reboots the machine if C<REBOOT> is true.
  73.  
  74. =item NT::AbortSystemShutdown MACHINE
  75.  
  76. Aborts a shutdown on the specified C<MACHINE>.
  77.  
  78. =cut
  79.