win32

func CloseHandle ¶

func CloseHandle(handle syscall.Handle) (err error)

func CoTaskMemFree ¶

func CoTaskMemFree(pv uintptr)

https://msdn.microsoft.com/en-us/library/windows/desktop/ms680722(v=vs.85).aspx Note: the system call returns no value, so we can't check for an error

func CreateEnvironment ¶

func CreateEnvironment(env *[]string, hUser syscall.Handle) (mergedEnv *[]string, err error)

CreateEnvironment returns an environment block, suitable for use with the CreateProcessAsUser system call. The default environment variables of hUser are overlayed with values in env.

func CreateEnvironmentBlock ¶

func CreateEnvironmentBlock(
	lpEnvironment *uintptr,
	hToken syscall.Handle,
	bInherit bool,
) (err error)

https://msdn.microsoft.com/en-us/library/windows/desktop/bb762270(v=vs.85).aspx

func DestroyEnvironmentBlock ¶

func DestroyEnvironmentBlock(
	lpEnvironment uintptr,
) (err error)

https://msdn.microsoft.com/en-us/library/windows/desktop/bb762274(v=vs.85).aspx

func GetFolder ¶

func GetFolder(hUser syscall.Handle, folder *syscall.GUID, dwFlags uint32) (value string, err error)

func GetLinkedToken ¶

func GetLinkedToken(hToken syscall.Token) (syscall.Token, error)

func GetProfilesDirectory ¶

func GetProfilesDirectory(
	lpProfilesDir *uint16,
	lpcchSize *uint32,
) (err error)

https://msdn.microsoft.com/en-us/library/windows/desktop/bb762278(v=vs.85).aspx BOOL WINAPI GetProfilesDirectory(

_Out_   LPTSTR  lpProfilesDir,
_Inout_ LPDWORD lpcchSize

);

func GetTokenInformation ¶

func GetTokenInformation(
	tokenHandle syscall.Token,
	tokenInformationClass TOKEN_INFORMATION_CLASS,
	tokenInformation uintptr,
	tokenInformationLength uintptr,
	returnLength *uintptr,
) (err error)

https://msdn.microsoft.com/en-us/library/windows/desktop/aa446671(v=vs.85).aspx BOOL WINAPI GetTokenInformation(

_In_      HANDLE                  TokenHandle,
_In_      TOKEN_INFORMATION_CLASS TokenInformationClass,
_Out_opt_ LPVOID                  TokenInformation,
_In_      DWORD                   TokenInformationLength,
_Out_     PDWORD                  ReturnLength

);

func GetUserProfileDirectory ¶

func GetUserProfileDirectory(
	hToken syscall.Handle,
	lpProfileDir *uint16,
	lpcchSize *uint32,
) (err error)

https://msdn.microsoft.com/en-us/library/windows/desktop/bb762280(v=vs.85).aspx BOOL WINAPI GetUserProfileDirectory(

_In_      HANDLE  hToken,
_Out_opt_ LPTSTR  lpProfileDir,
_Inout_   LPDWORD lpcchSize

);

func InteractiveUserToken ¶

func InteractiveUserToken(timeout time.Duration) (hToken syscall.Handle, err error)

InteractiveUserToken returns a user token (security context) for the interactive desktop session attached to the default console (i.e. what would be seen on a display connected directly to the computer, rather than a remote RDP session). It must be called from a process which is running under LocalSystem account in order to have the necessary privileges (typically a Windows service). Since the service might be running before a local logon occurs, a timeout can be specified for waiting for a successful logon (via winlogon) to occur. The returned token can be used in e.g. CreateProcessAsUser system call, which allows e.g. a Windows service to run a process in the interactive desktop session, as if the logged in user had executed the process directly. The function additionally waits for the user profile directory to exist, before returning.

func IsWindows8OrGreater ¶

func IsWindows8OrGreater() bool

func LoadUserProfile ¶

func LoadUserProfile(token syscall.Handle, pinfo *ProfileInfo) error

func LogonUser ¶

func LogonUser(username *uint16, domain *uint16, password *uint16, logonType uint32, logonProvider uint32) (token syscall.Handle, err error)

func MergeEnvLists ¶

func MergeEnvLists(envLists ...*[]string) (*[]string, error)

package main

import (
	"fmt"
	"log"

	"github.com/taskcluster/generic-worker/win32"
)

func main() {
	lists := []*[]string{
		{
			"a=dog",
			"Pete=man",
			"x=ray",
		}, {
			"food=good",
			"PETE=person",
		},
	}
	res, err := win32.MergeEnvLists(lists...)
	if err != nil {
		log.Fatalf("Hit error: %v", err)
	}
	fmt.Println(*res)
}

Output:

[a=dog food=good Pete=person x=ray]

func ProfileDirectory ¶

func ProfileDirectory(hToken syscall.Handle) (string, error)

ProfileDirectory returns the profile directory of the user represented by the given user handle

func ProfilesDirectory ¶

func ProfilesDirectory() string

ProfilesDirectory returns the folder where user profiles get created, typically `C:\Users`

func SHGetKnownFolderPath ¶

func SHGetKnownFolderPath(rfid *syscall.GUID, dwFlags uint32, hToken syscall.Handle, pszPath *uintptr) (err error)

https://msdn.microsoft.com/en-us/library/windows/desktop/bb762188(v=vs.85).aspx

func SHSetKnownFolderPath ¶

func SHSetKnownFolderPath(
	rfid *syscall.GUID,
	dwFlags uint32,
	hToken syscall.Handle,
	pszPath *uint16,
) (err error)

https://msdn.microsoft.com/en-us/library/windows/desktop/bb762249(v=vs.85).aspx

func SetAndCreateFolder ¶

func SetAndCreateFolder(hUser syscall.Handle, folder *syscall.GUID, value string) (err error)

func SetFolder ¶

func SetFolder(hUser syscall.Handle, folder *syscall.GUID, value string) (err error)

func UnloadUserProfile ¶

func UnloadUserProfile(token, profile syscall.Handle) error

func VerSetConditionMask ¶

func VerSetConditionMask(lConditionMask uint64, typeBitMask uint32, conditionMask uint8) uint64

func VerifyWindowsInfoW ¶

func VerifyWindowsInfoW(vi OSVersionInfoEx, typeMask uint32, conditionMask uint64) (bool, error)

func WTSGetActiveConsoleSessionId ¶

func WTSGetActiveConsoleSessionId() (sessionId uint32, err error)

https://msdn.microsoft.com/en-us/library/aa383835(VS.85).aspx DWORD WTSGetActiveConsoleSessionId(void);

func WTSQueryUserToken ¶

func WTSQueryUserToken(
	sessionId uint32,
	phToken *syscall.Handle,
) (err error)

https://msdn.microsoft.com/en-us/library/aa383840(VS.85).aspx BOOL WTSQueryUserToken(

_In_  ULONG   SessionId,
_Out_ PHANDLE phToken

);