---
name: "Padre::Util::Win32"
section: "3pm"
platform: "linux"
package: "padre"
version: "1.00+dfsg-3"
release: "Debian 8 (Jessie)"
platforms: ["linux"]
url: "https://new.carta.tech/Padre::Util::Win32"
---

# Padre::Util::Win32(3pm)

Padre Win32 API Functions

## NAME

Padre::Util::Win32 - Padre Win32 API Functions

## DESCRIPTION

The `"Padre::Util::Win32"` package provides an XS wrapper for Win32 API functions

All functions are exportable and documented for maintenance purposes, but except for in the Padre core distribution you are discouraged in the strongest possible terms from using these functions, as they may be moved, removed or changed at any time without notice.

## FUNCTIONS

### "GetLongPathName"

```
  Padre::Util::Win32::GetLongPathName($path);
```

Converts the specified path `$path` to its long form. Returns `"undef"` for failure, or the long form of the specified path

### "Recycle"

```
  Padre::Util::Win32::Recycle($file_to_recycle);
```

Move `$file_to_recycle` to recycle bin Returns `"undef"` (failed), zero (aborted) or one (success)

### "AllowSetForegroundWindow"

```
  Padre::Util::Win32::AllowSetForegroundWindow($pid);
```

Enables the specified process `$pid` to set the foreground window via `"SetForegroundWindow"`

\<http://msdn.microsoft.com/en-us/library/ms633539(VS.85).aspx\>

### "ExecuteProcessAndWait"

```
  Padre::Util::Win32::ExecuteProcessAndWait(
      directory  => $directory,
      file       => $file,
      parameters => $parameters,
      show       => $show,
  )
```

Execute a background process named "`$file` `$parameters`" with the current directory set to `$directory` and wait for it to end. If you set `$show` to 0, then you have an invisible command line window on win32!

### "GetCurrentProcessMemorySize"

```
  Padre::Util::Win32::GetCurrentProcessMemorySize;
```

Returns the current process memory size in bytes

### "GetLastErrorString"

```
  Padre::Util::Win32::GetLastError;
```

Returns the error code of the last Win32 API call.

The list of error codes could be found at \<http://msdn.microsoft.com/en-us/library/ms681381(VS.85).aspx\>.

### "GetLastErrorString"

```
  Padre::Util::Win32::GetLastErrorString;
```

Returns the string representation for the error code of the last Win32 API call.

## COPYRIGHT

Copyright 2008-2013 The Padre development team as listed in Padre.pm.

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

The full text of the license can be found in the LICENSE file included with this module.