windowsexec

Documentation

Index

• Constants
• func RunAsAndWait(file, directory string, timeout time.Duration, parameters []string) error

Constants

const (
	// SEE_MASK_NOCLOSEPROCESS (0x00000040):
	// Use to indicate that the hProcess member receives the process handle.
	// This handle is typically used to allow an application to find out when a
	// process created with ShellExecuteEx terminates. In some cases, such as
	// when execution is satisfied through a DDE conversation, no handle will be
	// returned. The calling application is responsible for closing the handle
	// when it is no longer needed.
	SEE_MASK_NOCLOSEPROCESS = 0x40
)

These consts are copied verbatim from https://learn.microsoft.com/en-us/windows/win32/api/shellapi/ns-shellapi-shellexecuteinfow

Functions

func RunAsAndWait

func RunAsAndWait(
	file, directory string, timeout time.Duration, parameters []string,
) error

RunAsAndWait uses `ShellExecuteExW` to create a new process with elevated privileges on Windows. It waits for the process to exit, or until timeout, is exhausted. It will return an error if the process exits with a non-zero status code.