com.sun.jna.platform.win32.Shell32 Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of platform Show documentation
Show all versions of platform Show documentation
Java Native Access Platform
/* Copyright (c) 2007 Timothy Wall, All Rights Reserved
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Lesser General Public
* License as published by the Free Software Foundation; either
* version 2.1 of the License, or (at your option) any later version.
*
* This library is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*/
package com.sun.jna.platform.win32;
import com.sun.jna.Native;
import com.sun.jna.platform.win32.WinDef.DWORD;
import com.sun.jna.platform.win32.WinDef.HWND;
import com.sun.jna.platform.win32.WinDef.INT_PTR;
import com.sun.jna.platform.win32.WinNT.HANDLE;
import com.sun.jna.platform.win32.WinNT.HRESULT;
import com.sun.jna.ptr.PointerByReference;
import com.sun.jna.win32.StdCallLibrary;
import com.sun.jna.win32.W32APIOptions;
/**
* Shell32.dll Interface.
*/
public interface Shell32 extends ShellAPI, StdCallLibrary {
Shell32 INSTANCE = (Shell32) Native.loadLibrary("shell32", Shell32.class,
W32APIOptions.UNICODE_OPTIONS);
/**
* This function can be used to copy, move, rename, or delete a file system object.
* @param fileop
* Address of an SHFILEOPSTRUCT structure that contains information this function
* needs to carry out the specified operation.
* @return
* Returns zero if successful, or nonzero otherwise.
*/
int SHFileOperation(SHFILEOPSTRUCT fileop);
/**
* Takes the CSIDL of a folder and returns the path.
* @param hwndOwner
* Handle to an owner window. This parameter is typically set to NULL. If it is not NULL,
* and a dial-up connection needs to be made to access the folder, a user interface (UI)
* prompt will appear in this window.
* @param nFolder
* A CSIDL value that identifies the folder whose path is to be retrieved. Only real
* folders are valid. If a virtual folder is specified, this function will fail. You can
* force creation of a folder with SHGetFolderPath by combining the folder's CSIDL with
* CSIDL_FLAG_CREATE.
* @param hToken
* An access token that can be used to represent a particular user.
* @param dwFlags
* Flags to specify which path is to be returned.
* @param pszPath
* Pointer to a null-terminated string of length MAX_PATH which will receive the path.
* If an error occurs or S_FALSE is returned, this string will be empty.
* @return
* Returns standard HRESULT codes.
*/
HRESULT SHGetFolderPath(HWND hwndOwner, int nFolder, HANDLE hToken, DWORD dwFlags,
char[] pszPath);
/**
* Retrieves the IShellFolder interface for the desktop folder, which is the root of the Shell's namespace.
* The retrieved COM interface pointer can be used via Com4JNA's ComObject.wrapNativeInterface call
* given a suitable interface definition for IShellFolder
* @param ppshf A place to put the IShellFolder interface pointer
* @return If the function succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.
*/
HRESULT SHGetDesktopFolder( PointerByReference ppshf );
/**
* Performs an operation on a specified file.
*
* @param hwnd
* A handle to the owner window used for displaying a UI or error messages. This value can be NULL if the
* operation is not associated with a window.
*
* @param lpOperation
* A pointer to a null-terminated string, referred to in this case as a verb, that specifies the action to be
* performed. The set of available verbs depends on the particular file or folder. Generally, the actions
* available from an object's shortcut menu are available verbs. The following verbs are commonly used:
*
* edit
* Launches an editor and opens the document for editing. If lpFile is not a document file, the function will
* fail.
* explore
* Explores a folder specified by lpFile.
* find
* Initiates a search beginning in the directory specified by lpDirectory.
* open
* Opens the item specified by the lpFile parameter. The item can be a file or folder.
* print
* Prints the file specified by lpFile. If lpFile is not a document file, the function fails.
* NULL
* In systems prior to Windows 2000, the default verb is used if it is valid and available in the registry. If
* not, the "open" verb is used.
* In Windows 2000 and later, the default verb is used if available. If not, the "open" verb is used. If neither
* verb is available, the system uses the first verb listed in the registry.
*
* @param lpFile
* A pointer to a null-terminated string that specifies the file or object on which to execute the specified verb.
* To specify a Shell namespace object, pass the fully qualified parse name. Note that not all verbs are supported
* on all objects. For example, not all document types support the "print" verb. If a relative path is used for
* the lpDirectory parameter do not use a relative path for lpFile.
*
* @param lpParameters
* If lpFile specifies an executable file, this parameter is a pointer to a null-terminated string that specifies
* the parameters to be passed to the application. The format of this string is determined by the verb that is to
* be invoked. If lpFile specifies a document file, lpParameters should be NULL.
*
* @param lpDirectory
* A pointer to a null-terminated string that specifies the default (working) directory for the action. If this
* value is NULL, the current working directory is used. If a relative path is provided at lpFile, do not use a
* relative path for lpDirectory.
*
* @param nShowCmd
* The flags that specify how an application is to be displayed when it is opened. If lpFile specifies a document
* file, the flag is simply passed to the associated application. It is up to the application to decide how to
* handle it.
*
* @return
* If the function succeeds, it returns a value greater than 32. If the function fails, it returns an error value
* that indicates the cause of the failure. The return value is cast as an HINSTANCE for backward compatibility
* with 16-bit Windows applications. It is not a true HINSTANCE, however. It can be cast only to an int and
* compared to either 32 or the following error codes below.
*
* NOTE: {@link WinDef.INT_PTR} is used instead of HINSTANCE here, since
* the former fits the reutrn type's actual usage more closely.
*
* 0 The operating system is out of memory or resources.
* ERROR_FILE_NOT_FOUND The specified file was not found.
* ERROR_PATH_NOT_FOUND The specified path was not found.
* ERROR_BAD_FORMAT The .exe file is invalid (non-Win32 .exe or error in .exe image).
* SE_ERR_ACCESSDENIED The operating system denied access to the specified file.
* SE_ERR_ASSOCINCOMPLETE The file name association is incomplete or invalid.
* SE_ERR_DDEBUSY The DDE transaction could not be completed because other DDE transactions were being processed.
* SE_ERR_DDEFAIL The DDE transaction failed.
* SE_ERR_DDETIMEOUT The DDE transaction could not be completed because the request timed out.
* SE_ERR_DLLNOTFOUND The specified DLL was not found.
* SE_ERR_FNF The specified file was not found.
* SE_ERR_NOASSOC There is no application associated with the given file name extension. This error will also be
* returned if you attempt to print a file that is not printable.
* SE_ERR_OOM There was not enough memory to complete the operation.
* SE_ERR_PNF The specified path was not found.
* SE_ERR_SHARE A sharing violation occurred.
*/
INT_PTR ShellExecute(HWND hwnd, String lpOperation, String lpFile, String lpParameters, String lpDirectory,
int nShowCmd);
}