wellton/jna
1
0
Fork 0
Código Issues Pull Requests Ações Pacotes Projetos Versões Wiki Atividade

Added Winspool monitor sample and updated Kernel32, WinBase, Winspool

Ver Código-Fonte 
Added a full running Winspool monitor sample to demonstrate how to watch
for new print jobs added to the spooler on windows.
Esse commit está contido em:
Tobias
2014-05-23 09:55:38 +02:00
pai e0ff9cd8d3
commit 942380eadd
7 arquivos alterados com 678 adições e 140 exclusões
Baixar Arquivo de Patch Baixar Arquivo de Diff Expandir todos os arquivos Colapsar todos os arquivos
contrib/platform/src/com/sun/jna/platform/win32/Kernel32.java
+121 -40
Ver Arquivo
@@ -950,13 +950,13 @@ public interface Kernel32 extends WinNT {
/**
* Resets (to non-signaled state) the specified event object.
*
*
* @param hEvent
* A handle to the event object
*
* @return If the function succeeds, the return value is nonzero.
* If the function fails the return value is zero. To get
* extended error information, call GetLastError.
* A handle to the event object
*
* @return If the function succeeds, the return value is nonzero. If the
* function fails the return value is zero. To get extended error
* information, call GetLastError.
*/
boolean ResetEvent(HANDLE hEvent);
@@ -1993,65 +1993,146 @@ public interface Kernel32 extends WinNT {
*/
boolean WritePrivateProfileString(String lpAppName, String lpKeyName,
String lpString, String lpFileName);
/**
* Retrieves all the keys and values for the specified section of an initialization file.
*
* Retrieves all the keys and values for the specified section of an
* initialization file.
*
* <p>
* Each string has the following format: {@code key=string}.
* </p>
* <p>
* This operation is atomic; no updates to the specified initialization file are allowed while the key name and value pairs for the section are being copied
* to the buffer pointed to by the {@code lpReturnedString} parameter.
* This operation is atomic; no updates to the specified initialization file
* are allowed while the key name and value pairs for the section are being
* copied to the buffer pointed to by the {@code lpReturnedString}
* parameter.
* </p>
*
*
* @param lpAppName
* The name of the section in the initialization file.
* @param lpReturnedString
* A buffer that receives the key name and value pairs associated with the named section. The buffer is filled with one or more {@code null}
* -terminated strings; the last string is followed by a second {@code null} character.
* A buffer that receives the key name and value pairs associated
* with the named section. The buffer is filled with one or more
* {@code null} -terminated strings; the last string is followed
* by a second {@code null} character.
* @param nSize
* The size of the buffer pointed to by the {@code lpReturnedString} parameter, in characters. The maximum profile section size is 32,767
* characters.
* The size of the buffer pointed to by the
* {@code lpReturnedString} parameter, in characters. The maximum
* profile section size is 32,767 characters.
* @param lpFileName
* The name of the initialization file. If this parameter does not contain a full path to the file, the system searches for the file in the
* Windows directory.
* @return The number of characters copied to the buffer, not including the terminating null character. If the buffer is not large enough to contain all the
* key name and value pairs associated with the named section, the return value is equal to {@code nSize} minus two.
* The name of the initialization file. If this parameter does
* not contain a full path to the file, the system searches for
* the file in the Windows directory.
* @return The number of characters copied to the buffer, not including the
* terminating null character. If the buffer is not large enough to
* contain all the key name and value pairs associated with the
* named section, the return value is equal to {@code nSize} minus
* two.
*/
DWORD GetPrivateProfileSection(String lpAppName, char[] lpReturnedString, DWORD nSize, String lpFileName);
DWORD GetPrivateProfileSection(String lpAppName, char[] lpReturnedString,
DWORD nSize, String lpFileName);
/**
* Retrieves the names of all sections in an initialization file.
* <p>
* This operation is atomic; no updates to the initialization file are allowed while the section names are being copied to the buffer.
* This operation is atomic; no updates to the initialization file are
* allowed while the section names are being copied to the buffer.
* </p>
*
*
* @param lpszReturnBuffer
* A pointer to a buffer that receives the section names associated with the named file. The buffer is filled with one or more {@code null}
* -terminated strings; the last string is followed by a second {@code null} character.
* A pointer to a buffer that receives the section names
* associated with the named file. The buffer is filled with one
* or more {@code null} -terminated strings; the last string is
* followed by a second {@code null} character.
* @param nSize
* size of the buffer pointed to by the {@code lpszReturnBuffer} parameter, in characters.
* size of the buffer pointed to by the {@code lpszReturnBuffer}
* parameter, in characters.
* @param lpFileName
* The name of the initialization file. If this parameter is {@code NULL}, the function searches the Win.ini file. If this parameter does not
* contain a full path to the file, the system searches for the file in the Windows directory.
* @return The return value specifies the number of characters copied to the specified buffer, not including the terminating {@code null} character. If the
* buffer is not large enough to contain all the section names associated with the specified initialization file, the return value is equal to the
* size specified by {@code nSize} minus two.
* The name of the initialization file. If this parameter is
* {@code NULL}, the function searches the Win.ini file. If this
* parameter does not contain a full path to the file, the system
* searches for the file in the Windows directory.
* @return The return value specifies the number of characters copied to the
* specified buffer, not including the terminating {@code null}
* character. If the buffer is not large enough to contain all the
* section names associated with the specified initialization file,
* the return value is equal to the size specified by {@code nSize}
* minus two.
*/
DWORD GetPrivateProfileSectionNames(char[] lpszReturnBuffer, DWORD nSize, String lpFileName);
DWORD GetPrivateProfileSectionNames(char[] lpszReturnBuffer, DWORD nSize,
String lpFileName);
/**
* @param lpAppName
* The name of the section in which data is written. This section name is typically the name of the calling application.
* The name of the section in which data is written. This section
* name is typically the name of the calling application.
* @param lpString
* The new key names and associated values that are to be written to the named section. This string is limited to 65,535 bytes. Must be filled
* with zero or many {@code null}-terminated strings of the form {@code key=value}, appended by an additional {@code null} byte to terminate the
* list.
* The new key names and associated values that are to be written
* to the named section. This string is limited to 65,535 bytes.
* Must be filled with zero or many {@code null}-terminated
* strings of the form {@code key=value}, appended by an
* additional {@code null} byte to terminate the list.
* @param lpFileName
* The name of the initialization file. If this parameter does not contain a full path for the file, the function searches the Windows directory
* for the file. If the file does not exist and lpFileName does not contain a full path, the function creates the file in the Windows directory.
* @return If the function succeeds, the return value is nonzero. If the function fails, the return value is zero.
* The name of the initialization file. If this parameter does
* not contain a full path for the file, the function searches
* the Windows directory for the file. If the file does not exist
* and lpFileName does not contain a full path, the function
* creates the file in the Windows directory.
* @return If the function succeeds, the return value is nonzero. If the
* function fails, the return value is zero.
*/
boolean WritePrivateProfileSection(String lpAppName, String lpString, String lpFileName);
boolean WritePrivateProfileSection(String lpAppName, String lpString,
String lpFileName);
/**
* Converts a file time to a local file time.
*
* @param lpFileTime
* [in] A pointer to a FILETIME structure containing the
* UTC-based file time to be converted into a local file time.
* @param lpLocalFileTime
* [out] A pointer to a FILETIME structure to receive the
* converted local file time. This parameter cannot be the same
* as the lpFileTime parameter.
* @return If the function succeeds, the return value is nonzero. If the
* function fails, the return value is zero. To get extended error
* information, call GetLastError.
*/
boolean FileTimeToLocalFileTime(FILETIME lpFileTime,
FILETIME lpLocalFileTime);
/**
* Converts a time in Coordinated Universal Time (UTC) to a specified time
* zone's corresponding local time.
*
* @param lpTimeZone
* [in, optional] A pointer to a TIME_ZONE_INFORMATION structure
* that specifies the time zone of interest. If lpTimeZone is
* NULL, the function uses the currently active time zone.<
* @param lpUniversalTime
* [in] A pointer to a SYSTEMTIME structure that specifies the
* UTC time to be converted. The function converts this universal
* time to the specified time zone's corresponding local time.
* @return lpLocalTime [out] A pointer to a SYSTEMTIME structure that
* receives the local time.
*/
boolean SystemTimeToTzSpecificLocalTime(TIME_ZONE_INFORMATION lpTimeZone,
SYSTEMTIME lpUniversalTime, SYSTEMTIME lpLocalTime);
/**
* Converts a system time to file time format. System time is based on
* Coordinated Universal Time (UTC).
*
* @param lpSystemTime
* [in] A pointer to a SYSTEMTIME structure that contains the
* system time to be converted from UTC to file time format.
* @param lpFileTime
* [out] A pointer to a FILETIME structure to receive the
* converted system time.
* @return If the function succeeds, the return value is nonzero. If the
* function fails, the return value is zero. To get extended error
* information, call GetLastError.
*/
boolean SystemTimeToFileTime(SYSTEMTIME lpSystemTime, FILETIME lpFileTime);
}
contrib/platform/src/com/sun/jna/platform/win32/WinBase.java
+19 -2
Ver Arquivo
@@ -162,7 +162,6 @@ public interface WinBase extends StdCallLibrary, WinDef, BaseTSD {
*/
int STILL_ACTIVE = WinNT.STATUS_PENDING;
/**
* The FILETIME structure is a 64-bit value representing the number of
* 100-nanosecond intervals since January 1, 1601 (UTC).
@@ -304,6 +303,24 @@ public interface WinBase extends StdCallLibrary, WinDef, BaseTSD {
}
}
/**
* Specifies settings for a time zone.
* http://msdn.microsoft.com/en-us/library/windows/desktop/ms725481(v=vs.85).aspx
*/
public static class TIME_ZONE_INFORMATION extends Structure {
public LONG Bias;
public String StandardName;
public SYSTEMTIME StandardDate;
public LONG StandardBias;
public String DaylightName;
public SYSTEMTIME DaylightDate;
public LONG DaylightBias;
protected List getFieldOrder() {
return Arrays.asList(new String[] { "Bias", "StandardName", "StandardDate", "StandardBias", "DaylightName", "DaylightDate", "DaylightBias" });
}
}
/**
* The lpBuffer parameter is a pointer to a PVOID pointer, and that the nSize
* parameter specifies the minimum number of TCHARs to allocate for an output
@@ -396,7 +413,7 @@ public interface WinBase extends StdCallLibrary, WinDef, BaseTSD {
}
}
int INFINITE = 0xFFFFFFFF;
int INFINITE = 0xFFFFFFFF;
/**
* Contains information about the current computer system. This includes the architecture and
contrib/platform/src/com/sun/jna/platform/win32/Winspool.java
+394 -89
Ver Arquivo
@@ -19,106 +19,56 @@ import com.sun.jna.Memory;
import com.sun.jna.Native;
import com.sun.jna.Pointer;
import com.sun.jna.Structure;
import com.sun.jna.platform.win32.WinBase.SYSTEMTIME;
import com.sun.jna.platform.win32.WinDef.DWORD;
import com.sun.jna.platform.win32.WinDef.DWORDByReference;
import com.sun.jna.platform.win32.WinDef.LPVOID;
import com.sun.jna.platform.win32.WinDef.PVOID;
import com.sun.jna.platform.win32.WinNT.HANDLE;
import com.sun.jna.platform.win32.WinNT.HANDLEByReference;
import com.sun.jna.ptr.IntByReference;
import com.sun.jna.win32.StdCallLibrary;
import com.sun.jna.win32.W32APIOptions;
/**
* Ported from Winspool.h.
* Windows SDK 6.0a
* @author dblock[at]dblock.org
* Ported from Winspool.h. Windows SDK 6.0a
*
* @author dblock[at]dblock.org
*/
public interface Winspool extends StdCallLibrary {
Winspool INSTANCE = (Winspool) Native.loadLibrary("Winspool.drv", Winspool.class,
W32APIOptions.UNICODE_OPTIONS);
public final static int CCHDEVICENAME = 32;
/**
* The EnumPrinters function enumerates available printers, print servers, domains, or print providers.
* @param Flags
* The types of print objects that the function should enumerate.
* @param Name
* If Level is 1, Flags contains PRINTER_ENUM_NAME, and Name is non-NULL, then Name is a pointer
* to a null-terminated string that specifies the name of the object to enumerate. This string can
* be the name of a server, a domain, or a print provider.
* If Level is 1, Flags contains PRINTER_ENUM_NAME, and Name is NULL, then the function enumerates
* the available print providers.
* If Level is 1, Flags contains PRINTER_ENUM_REMOTE, and Name is NULL, then the function enumerates
* the printers in the user's domain.
* If Level is 2 or 5,Name is a pointer to a null-terminated string that specifies the name of a
* server whose printers are to be enumerated. If this string is NULL, then the function enumerates
* the printers installed on the local computer.
* If Level is 4, Name should be NULL. The function always queries on the local computer.
* When Name is NULL, setting Flags to PRINTER_ENUM_LOCAL | PRINTER_ENUM_CONNECTIONS enumerates
* printers that are installed on the local machine. These printers include those that are physically
* attached to the local machine as well as remote printers to which it has a network connection.
* When Name is not NULL, setting Flags to PRINTER_ENUM_LOCAL | PRINTER_ENUM_NAME enumerates the
* local printers that are installed on the server Name.
* @param Level
* The type of data structures pointed to by pPrinterEnum. Valid values are 1, 2, 4, and 5, which
* correspond to the PRINTER_INFO_1, PRINTER_INFO_2 , PRINTER_INFO_4, and PRINTER_INFO_5 data
* structures.
* @param pPrinterEnum
* A pointer to a buffer that receives an array of PRINTER_INFO_1, PRINTER_INFO_2, PRINTER_INFO_4,
* or PRINTER_INFO_5 structures. Each structure contains data that describes an available print
* object.
* If Level is 1, the array contains PRINTER_INFO_1 structures. If Level is 2, the array contains
* PRINTER_INFO_2 structures. If Level is 4, the array contains PRINTER_INFO_4 structures. If Level
* is 5, the array contains PRINTER_INFO_5 structures.
* The buffer must be large enough to receive the array of data structures and any strings or other
* data to which the structure members point. If the buffer is too small, the pcbNeeded parameter
* returns the required buffer size.
* @param cbBuf
* The size, in bytes, of the buffer pointed to by pPrinterEnum.
* @param pcbNeeded
* A pointer to a value that receives the number of bytes copied if the function succeeds or the
* number of bytes required if cbBuf is too small.
* @param pcReturned
* A pointer to a value that receives the number of PRINTER_INFO_1, PRINTER_INFO_2 , PRINTER_INFO_4,
* or PRINTER_INFO_5 structures that the function returns in the array to which pPrinterEnum points.
* @return
* If the function succeeds, the return value is a nonzero value.
* If the function fails, the return value is zero.
*/
boolean EnumPrinters(int Flags, String Name, int Level, Pointer pPrinterEnum,
int cbBuf, IntByReference pcbNeeded, IntByReference pcReturned);
public static class PRINTER_INFO_1 extends Structure {
public int Flags;
public String pDescription;
public String pName;
public String pComment;
protected List getFieldOrder() {
return Arrays.asList(new String[] { "Flags", "pDescription", "pName", "pComment" });
}
public PRINTER_INFO_1() {
}
public PRINTER_INFO_1(int size) {
super(new Memory(size));
}
}
public final static int PRINTER_CHANGE_ADD_PRINTER = 0x00000001;
public final static int PRINTER_CHANGE_SET_PRINTER = 0x00000002;
public final static int PRINTER_CHANGE_DELETE_PRINTER = 0x00000004;
public final static int PRINTER_CHANGE_FAILED_CONNECTION_PRINTER = 0x00000008;
public final static int PRINTER_CHANGE_PRINTER = 0x000000FF;
public final static int PRINTER_CHANGE_ADD_JOB = 0x00000100;
public final static int PRINTER_CHANGE_SET_JOB = 0x00000200;
public final static int PRINTER_CHANGE_DELETE_JOB = 0x00000400;
public final static int PRINTER_CHANGE_WRITE_JOB = 0x00000800;
public final static int PRINTER_CHANGE_JOB = 0x0000FF00;
public final static int PRINTER_CHANGE_ADD_FORM = 0x00010000;
public final static int PRINTER_CHANGE_SET_FORM = 0x00020000;
public final static int PRINTER_CHANGE_DELETE_FORM = 0x00040000;
public final static int PRINTER_CHANGE_FORM = 0x00070000;
public final static int PRINTER_CHANGE_ADD_PORT = 0x00100000;
public final static int PRINTER_CHANGE_CONFIGURE_PORT = 0x00200000;
public final static int PRINTER_CHANGE_DELETE_PORT = 0x00400000;
public final static int PRINTER_CHANGE_PORT = 0x00700000;
public final static int PRINTER_CHANGE_ADD_PRINT_PROCESSOR = 0x01000000;
public final static int PRINTER_CHANGE_DELETE_PRINT_PROCESSOR = 0x04000000;
public final static int PRINTER_CHANGE_PRINT_PROCESSOR = 0x07000000;
public final static int PRINTER_CHANGE_SERVER = 0x08000000;
public final static int PRINTER_CHANGE_ADD_PRINTER_DRIVER = 0x10000000;
public final static int PRINTER_CHANGE_SET_PRINTER_DRIVER = 0x20000000;
public final static int PRINTER_CHANGE_DELETE_PRINTER_DRIVER = 0x40000000;
public final static int PRINTER_CHANGE_PRINTER_DRIVER = 0x70000000;
public final static int PRINTER_CHANGE_TIMEOUT = 0x80000000;
public final static int PRINTER_CHANGE_ALL_WIN7 = 0x7F77FFFF;
public final static int PRINTER_CHANGE_ALL = 0x7777FFFF;
public static class PRINTER_INFO_4 extends Structure {
public String pPrinterName;
public String pServerName;
public DWORD Attributes;
protected List getFieldOrder() {
return Arrays.asList(new String[] { "pPrinterName", "pServerName", "Attributes" });
}
public PRINTER_INFO_4() {
}
public PRINTER_INFO_4(int size) {
super(new Memory(size));
}
}
int PRINTER_ENUM_DEFAULT = 0x00000001;
int PRINTER_ENUM_LOCAL = 0x00000002;
int PRINTER_ENUM_CONNECTIONS = 0x00000004;
@@ -141,4 +91,359 @@ public interface Winspool extends StdCallLibrary {
int PRINTER_ENUM_ICON7 = 0x00400000;
int PRINTER_ENUM_ICON8 = 0x00800000;
int PRINTER_ENUM_HIDE = 0x01000000;
Winspool INSTANCE = (Winspool) Native.loadLibrary("Winspool.drv",
Winspool.class, W32APIOptions.UNICODE_OPTIONS);
/**
* The EnumPrinters function enumerates available printers, print servers,
* domains, or print providers.
*
* @param Flags
* The types of print objects that the function should enumerate.
* @param Name
* If Level is 1, Flags contains PRINTER_ENUM_NAME, and Name is
* non-NULL, then Name is a pointer to a null-terminated string
* that specifies the name of the object to enumerate. This
* string can be the name of a server, a domain, or a print
* provider. If Level is 1, Flags contains PRINTER_ENUM_NAME, and
* Name is NULL, then the function enumerates the available print
* providers. If Level is 1, Flags contains PRINTER_ENUM_REMOTE,
* and Name is NULL, then the function enumerates the printers in
* the user's domain. If Level is 2 or 5,Name is a pointer to a
* null-terminated string that specifies the name of a server
* whose printers are to be enumerated. If this string is NULL,
* then the function enumerates the printers installed on the
* local computer. If Level is 4, Name should be NULL. The
* function always queries on the local computer. When Name is
* NULL, setting Flags to PRINTER_ENUM_LOCAL |
* PRINTER_ENUM_CONNECTIONS enumerates printers that are
* installed on the local machine. These printers include those
* that are physically attached to the local machine as well as
* remote printers to which it has a network connection. When
* Name is not NULL, setting Flags to PRINTER_ENUM_LOCAL |
* PRINTER_ENUM_NAME enumerates the local printers that are
* installed on the server Name.
* @param Level
* The type of data structures pointed to by pPrinterEnum. Valid
* values are 1, 2, 4, and 5, which correspond to the
* PRINTER_INFO_1, PRINTER_INFO_2 , PRINTER_INFO_4, and
* PRINTER_INFO_5 data structures.
* @param pPrinterEnum
* A pointer to a buffer that receives an array of
* PRINTER_INFO_1, PRINTER_INFO_2, PRINTER_INFO_4, or
* PRINTER_INFO_5 structures. Each structure contains data that
* describes an available print object. If Level is 1, the array
* contains PRINTER_INFO_1 structures. If Level is 2, the array
* contains PRINTER_INFO_2 structures. If Level is 4, the array
* contains PRINTER_INFO_4 structures. If Level is 5, the array
* contains PRINTER_INFO_5 structures. The buffer must be large
* enough to receive the array of data structures and any strings
* or other data to which the structure members point. If the
* buffer is too small, the pcbNeeded parameter returns the
* required buffer size.
* @param cbBuf
* The size, in bytes, of the buffer pointed to by pPrinterEnum.
* @param pcbNeeded
* A pointer to a value that receives the number of bytes copied
* if the function succeeds or the number of bytes required if
* cbBuf is too small.
* @param pcReturned
* A pointer to a value that receives the number of
* PRINTER_INFO_1, PRINTER_INFO_2 , PRINTER_INFO_4, or
* PRINTER_INFO_5 structures that the function returns in the
* array to which pPrinterEnum points.
* @return If the function succeeds, the return value is a nonzero value. If
* the function fails, the return value is zero.
*/
boolean EnumPrinters(int Flags, String Name, int Level,
Pointer pPrinterEnum, int cbBuf, IntByReference pcbNeeded,
IntByReference pcReturned);
public static class PRINTER_INFO_1 extends Structure {
public int Flags;
public String pDescription;
public String pName;
public String pComment;
protected List getFieldOrder() {
return Arrays.asList(new String[] { "Flags", "pDescription",
"pName", "pComment" });
}
public PRINTER_INFO_1() {
}
public PRINTER_INFO_1(int size) {
super(new Memory(size));
}
}
public static class PRINTER_INFO_4 extends Structure {
public String pPrinterName;
public String pServerName;
public DWORD Attributes;
protected List getFieldOrder() {
return Arrays.asList(new String[] { "pPrinterName", "pServerName",
"Attributes" });
}
public PRINTER_INFO_4() {
}
public PRINTER_INFO_4(int size) {
super(new Memory(size));
}
}
public class LPPRINTER_DEFAULTS extends Structure {
public String pDatatype;
PVOID pDevMode;
int DesiredAccess;
protected List getFieldOrder() {
return Arrays.asList(new String[] { "pDatatype", "pDevMode",
"DesiredAccess" });
}
}
/**
* The OpenPrinter function retrieves a handle to the specified printer or
* print server or other types of handles in the print subsystem.
*
* {@link http://msdn
* .microsoft.com/en-us/library/windows/desktop/dd162751(v=vs.85).aspx}
*
* @param pPrinterName
* [in] A pointer to a null-terminated string that specifies the
* name of the printer or print server, the printer object, the
* XcvMonitor, or the XcvPort. For a printer object use:
* PrinterName, Job xxxx. For an XcvMonitor, use: ServerName,
* XcvMonitor MonitorName. For an XcvPort, use: ServerName,
* XcvPort PortName. If NULL, it indicates the local printer
* server.
* @param phPrinter
* [out] A pointer to a variable that receives a handle (not
* thread safe) to the open printer or print server object. The
* phPrinter parameter can return an Xcv handle for use with the
* XcvData function. For more information about XcvData, see the
* DDK.
* @param pDefault
* [in] A pointer to a PRINTER_DEFAULTS structure. This value can
* be NULL.
* @return If the function succeeds, the return value is a nonzero value. If
* the function fails, the return value is zero.
*/
boolean OpenPrinter(
// _In_
String pPrinterName,
// _Out_
HANDLEByReference phPrinter,
// _In_
LPPRINTER_DEFAULTS pDefault);
/**
* The FindFirstPrinterChangeNotification function creates a change
* notification object and returns a handle to the object. You can then use
* this handle in a call to one of the wait functions to monitor changes to
* the printer or print server. The FindFirstPrinterChangeNotification call
* specifies the type of changes to be monitored. You can specify a set of
* conditions to monitor for changes, a set of printer information fields to
* monitor, or both. A wait operation on the change notification handle
* succeeds when one of the specified changes occurs in the specified
* printer or print server. You then call the
* FindNextPrinterChangeNotification function to retrieve information about
* the change, and to reset the change notification object for use in the
* next wait operation.
*
* {@link http
* ://msdn.microsoft.com/en-us/library/windows/desktop/dd162722(v=
* vs.85).aspx}
*
* @param hPrinter
* [in] A handle to the printer or print server that you want to
* monitor. Use the OpenPrinter or AddPrinter function to
* retrieve a printer handle.
* @param phPrinter
* [out] A pointer to a variable that receives a handle (not
* thread safe) to the open printer or print server object. The
* phPrinter parameter can return an Xcv handle for use with the
* XcvData function. For more information about XcvData, see the
* DDK.
* @param fdwFilter
* The conditions that will cause the change notification object
* to enter a signaled state. A change notification occurs when
* one or more of the specified conditions are met. The fdwFilter
* parameter can be zero if pPrinterNotifyOptions is non-NULL.
*
* @param fdwOptions
* Reserved; must be zero. pPrinterNotifyOptions [in, optional] A
* pointer to a PRINTER_NOTIFY_OPTIONS structure. The pTypes
* member of this structure is an array of one or more
* PRINTER_NOTIFY_OPTIONS_TYPE structures, each of which
* specifies a printer information field to monitor. A change
* notification occurs when one or more of the specified fields
* changes. When a change occurs, the
* FindNextPrinterChangeNotification function can retrieve the
* new printer information. This parameter can be NULL if
* fdwFilter is nonzero. For a list of fields that can be
* monitored, see PRINTER_NOTIFY_OPTIONS_TYPE.
*
* @return If the function succeeds, the return value is a handle to a
* change notification object associated with the specified printer
* or print server. If the function fails, the return value is
* INVALID_HANDLE_VALUE.
*/
HANDLE FindFirstPrinterChangeNotification(
// _In_
HANDLE hPrinter, int fdwFilter, int fdwOptions,
// _In_opt_
LPVOID pPrinterNotifyOptions);
/**
* The FindNextPrinterChangeNotification function retrieves information
* about the most recent change notification for a change notification
* object associated with a printer or print server. Call this function when
* a wait operation on the change notification object is satisfied. The
* function also resets the change notification object to the not-signaled
* state. You can then use the object in another wait operation to continue
* monitoring the printer or print server. The operating system will set the
* object to the signaled state the next time one of a specified set of
* changes occurs to the printer or print server. The
* FindFirstPrinterChangeNotification function creates the change
* notification object and specifies the set of changes to be monitored.
*
* {@link http
* ://msdn.microsoft.com/en-us/library/windows/desktop/dd162721(v=
* vs.85).aspx}
*
* @param hChange
* [in] A handle to a change notification object associated with
* a printer or print server. You obtain such a handle by calling
* the FindFirstPrinterChangeNotification function. The operating
* system sets this change notification object to the signaled
* state when it detects one of the changes specified in the
* object's change notification filter.
* @param pdwChange
* [out, optional] A pointer to a variable whose bits are set to
* indicate the changes that occurred to cause the most recent
* notification. The bit flags that might be set correspond to
* those specified in the fdwFilter parameter of the
* FindFirstPrinterChangeNotification call. The system sets one
* or more of the following bit flags.
*
* @param pPrinterNotifyOptions
* [in, optional] A pointer to a PRINTER_NOTIFY_OPTIONS
* structure. Set the Flags member of this structure to
* PRINTER_NOTIFY_OPTIONS_REFRESH, to cause the function to
* return the current data for all monitored printer information
* fields. The function ignores all other members of the
* structure. This parameter can be NULL.
*
* @param ppPrinterNotifyInfo
* [out, optional] A pointer to a pointer variable that receives
* a pointer to a system-allocated, read-only buffer. Call the
* FreePrinterNotifyInfo function to free the buffer when you are
* finished with it. This parameter can be NULL if no information
* is required. The buffer contains a PRINTER_NOTIFY_INFO
* structure, which contains an array of PRINTER_NOTIFY_INFO_DATA
* structures. Each element of the array contains information
* about one of the fields specified in the pPrinterNotifyOptions
* parameter of the FindFirstPrinterChangeNotification call.
* Typically, the function provides data only for the fields that
* changed to cause the most recent notification. However, if the
* structure pointed to by the pPrinterNotifyOptions parameter
* specifies PRINTER_NOTIFY_OPTIONS_REFRESH, the function
* provides data for all monitored fields. If the
* PRINTER_NOTIFY_INFO_DISCARDED bit is set in the Flags member
* of the PRINTER_NOTIFY_INFO structure, an overflow or error
* occurred, and notifications may have been lost. In this case,
* no additional notifications will be sent until you make a
* second FindNextPrinterChangeNotification call that specifies
* PRINTER_NOTIFY_OPTIONS_REFRESH.
*
* @return If the function succeeds, the return value is a nonzero value. If
* the function fails, the return value is zero.
*/
boolean FindNextPrinterChangeNotification(
// _In_
HANDLE hChange,
// _Out_opt_
DWORDByReference pdwChange,
// _In_opt_
LPVOID pPrinterNotifyOptions,
// _Out_opt_
LPVOID ppPrinterNotifyInfo);
/**
* The FindClosePrinterChangeNotification function closes a change
* notification object created by calling the
* FindFirstPrinterChangeNotification function. The printer or print server
* associated with the change notification object will no longer be
* monitored by that object.
*
* {@link http
* ://msdn.microsoft.com/en-us/library/windows/desktop/dd162721(v=
* vs.85).aspx}
*
* @param hChange
* [in] A handle to the change notification object to be closed.
* This is a handle created by calling the
* FindFirstPrinterChangeNotification function.
*
* @return If the function succeeds, the return value is a nonzero value. If
* the function fails, the return value is zero.
*/
boolean FindClosePrinterChangeNotification(
// _In_
HANDLE hChange);
boolean EnumJobs(
// _In_
HANDLE hPrinter,
// _In_
int FirstJob,
// _In_
int NoJobs,
// _In_
int Level,
// _Out_
Pointer pJob,
// _In_
int cbBuf,
// _Out_
IntByReference pcbNeeded,
// _Out_
IntByReference pcReturned);
public static class JOB_INFO_1 extends Structure {
public int JobId;
public String pPrinterName;
public String pMachineName;
public String pUserName;
public String pDocument;
public String pDatatype;
public String pStatus;
public int Status;
public int Priority;
public int Position;
public int TotalPages;
public int PagesPrinted;
public SYSTEMTIME Submitted;
protected List getFieldOrder() {
return Arrays.asList(new String[] { "JobId", "pPrinterName",
"pMachineName", "pUserName", "pDocument", "pDatatype",
"pStatus", "Status", "Priority", "Position", "TotalPages",
"PagesPrinted", "Submitted" });
}
public JOB_INFO_1() {
}
public JOB_INFO_1(int size) {
super(new Memory(size));
}
}
}
contrib/platform/src/com/sun/jna/platform/win32/WinspoolUtil.java
+35 -9
Ver Arquivo
@@ -12,13 +12,15 @@
*/
package com.sun.jna.platform.win32;
import com.sun.jna.platform.win32.WinNT.HANDLEByReference;
import com.sun.jna.platform.win32.Winspool.JOB_INFO_1;
import com.sun.jna.platform.win32.Winspool.PRINTER_INFO_1;
import com.sun.jna.platform.win32.Winspool.PRINTER_INFO_4;
import com.sun.jna.ptr.IntByReference;
/**
* Winspool Utility API.
*
*
* @author dblock[at]dblock.org
*/
public abstract class WinspoolUtil {
@@ -26,15 +28,16 @@ public abstract class WinspoolUtil {
public static PRINTER_INFO_1[] getPrinterInfo1() {
IntByReference pcbNeeded = new IntByReference();
IntByReference pcReturned = new IntByReference();
Winspool.INSTANCE.EnumPrinters(Winspool.PRINTER_ENUM_LOCAL,
null, 1, null, 0, pcbNeeded, pcReturned);
Winspool.INSTANCE.EnumPrinters(Winspool.PRINTER_ENUM_LOCAL, null, 1,
null, 0, pcbNeeded, pcReturned);
if (pcbNeeded.getValue() <= 0) {
return new PRINTER_INFO_1[0];
}
PRINTER_INFO_1 pPrinterEnum = new PRINTER_INFO_1(pcbNeeded.getValue());
if (!Winspool.INSTANCE.EnumPrinters(Winspool.PRINTER_ENUM_LOCAL,
null, 1, pPrinterEnum.getPointer(), pcbNeeded.getValue(), pcbNeeded, pcReturned)) {
if (!Winspool.INSTANCE.EnumPrinters(Winspool.PRINTER_ENUM_LOCAL, null,
1, pPrinterEnum.getPointer(), pcbNeeded.getValue(), pcbNeeded,
pcReturned)) {
throw new Win32Exception(Kernel32.INSTANCE.GetLastError());
}
@@ -46,15 +49,16 @@ public abstract class WinspoolUtil {
public static PRINTER_INFO_4[] getPrinterInfo4() {
IntByReference pcbNeeded = new IntByReference();
IntByReference pcReturned = new IntByReference();
Winspool.INSTANCE.EnumPrinters(Winspool.PRINTER_ENUM_LOCAL,
null, 4, null, 0, pcbNeeded, pcReturned);
Winspool.INSTANCE.EnumPrinters(Winspool.PRINTER_ENUM_LOCAL, null, 4,
null, 0, pcbNeeded, pcReturned);
if (pcbNeeded.getValue() <= 0) {
return new PRINTER_INFO_4[0];
}
PRINTER_INFO_4 pPrinterEnum = new PRINTER_INFO_4(pcbNeeded.getValue());
if (!Winspool.INSTANCE.EnumPrinters(Winspool.PRINTER_ENUM_LOCAL,
null, 4, pPrinterEnum.getPointer(), pcbNeeded.getValue(), pcbNeeded, pcReturned)) {
if (!Winspool.INSTANCE.EnumPrinters(Winspool.PRINTER_ENUM_LOCAL, null,
4, pPrinterEnum.getPointer(), pcbNeeded.getValue(), pcbNeeded,
pcReturned)) {
throw new Win32Exception(Kernel32.INSTANCE.GetLastError());
}
@@ -62,4 +66,26 @@ public abstract class WinspoolUtil {
return (PRINTER_INFO_4[]) pPrinterEnum.toArray(pcReturned.getValue());
}
public static JOB_INFO_1[] getJobInfo1(HANDLEByReference phPrinter) {
IntByReference pcbNeeded = new IntByReference();
IntByReference pcReturned = new IntByReference();
Winspool.INSTANCE.EnumJobs(phPrinter.getValue(), 0, 255, 1, null, 0,
pcbNeeded, pcReturned);
if (pcbNeeded.getValue() <= 0) {
return new JOB_INFO_1[0];
}
JOB_INFO_1 pJobEnum = new JOB_INFO_1(pcbNeeded.getValue());
if (!Winspool.INSTANCE.EnumJobs(phPrinter.getValue(), 0, 255, 1,
pJobEnum.getPointer(), pcbNeeded.getValue(), pcbNeeded,
pcReturned)) {
throw new Win32Exception(Kernel32.INSTANCE.GetLastError());
}
pJobEnum.read();
return (JOB_INFO_1[]) pJobEnum.toArray(pcReturned.getValue());
}
}
contrib/w32printing/.classpath
+6
Ver Arquivo
@@ -0,0 +1,6 @@
<?xml version="1.0" encoding="UTF-8"?>
<classpath>
<classpathentry kind="src" path="src"/>
<classpathentry kind="con" path="org.eclipse.jdt.launching.JRE_CONTAINER/org.eclipse.jdt.internal.debug.ui.launcher.StandardVMType/JavaSE-1.7"/>
<classpathentry kind="output" path="bin"/>
</classpath>
contrib/w32printing/.project
+17
Ver Arquivo
@@ -0,0 +1,17 @@
<?xml version="1.0" encoding="UTF-8"?>
<projectDescription>
<name>win32printing</name>
<comment></comment>
<projects>
</projects>
<buildSpec>
<buildCommand>
<name>org.eclipse.jdt.core.javabuilder</name>
<arguments>
</arguments>
</buildCommand>
</buildSpec>
<natures>
<nature>org.eclipse.jdt.core.javanature</nature>
</natures>
</projectDescription>
contrib/w32printing/src/com/sun/jna/platform/win32/Win32SpoolMonitor.java
+86
Ver Arquivo
@@ -0,0 +1,86 @@
package com.sun.jna.platform.win32;
import java.text.DateFormat;
import com.sun.jna.platform.win32.WinBase.FILETIME;
import com.sun.jna.platform.win32.WinBase.SYSTEMTIME;
import com.sun.jna.platform.win32.WinDef.DWORDByReference;
import com.sun.jna.platform.win32.WinNT.HANDLE;
import com.sun.jna.platform.win32.WinNT.HANDLEByReference;
import com.sun.jna.platform.win32.Winspool.JOB_INFO_1;
public class Win32SpoolMonitor {
public Win32SpoolMonitor() {
String pPrinterName = "HP Color LaserJet CM4730 MFP PCL 6";
HANDLEByReference phPrinter = new HANDLEByReference();
Winspool.INSTANCE.OpenPrinter(pPrinterName, phPrinter, null);
// Get change notification handle for the printer
HANDLE chgObject = Winspool.INSTANCE
.FindFirstPrinterChangeNotification(phPrinter.getValue(),
Winspool.PRINTER_CHANGE_JOB, 0, null);
if (chgObject != null) {
while (true) {
// Wait for the change notification
Kernel32.INSTANCE.WaitForSingleObject(chgObject,
WinBase.INFINITE);
DWORDByReference pdwChange = new DWORDByReference();
boolean fcnreturn = Winspool.INSTANCE
.FindNextPrinterChangeNotification(chgObject,
pdwChange, null, null);
if (fcnreturn) {
JOB_INFO_1[] jobInfo1 = WinspoolUtil.getJobInfo1(phPrinter);
for (int i = 0; i < jobInfo1.length; i++) {
this.printJobInfo(jobInfo1[i]);
}
break;
}
}
// Close Printer Change Notification handle when finished.
Winspool.INSTANCE.FindClosePrinterChangeNotification(chgObject);
} else {
// Unable to open printer change notification handle
getLastError();
}
}
public int getLastError() {
int rc = Kernel32.INSTANCE.GetLastError();
if (rc != 0)
System.out.println("error: " + rc);
return rc;
}
private void printJobInfo(JOB_INFO_1 jobInfo1) {
FILETIME lpFileTime = new FILETIME();
Kernel32.INSTANCE.SystemTimeToFileTime(jobInfo1.Submitted, lpFileTime);
String info = "JobId: " + jobInfo1.JobId + "\n" + "pDatatype: "
+ jobInfo1.pDatatype + "\n" + "PagesPrinted: "
+ jobInfo1.PagesPrinted + "\n" + "pDocument: "
+ jobInfo1.pDocument + "\n" + "pMachineName: "
+ jobInfo1.pMachineName + "\n" + "Position: "
+ jobInfo1.Position + "\n" + "pPrinterName: "
+ jobInfo1.pPrinterName + "\n" + "Priority: "
+ jobInfo1.Priority + "\n" + "pStatus: " + jobInfo1.pStatus
+ "\n" + "pUserName: " + jobInfo1.pUserName + "\n" + "Status: "
+ jobInfo1.Status + "\n" + "TotalPages: " + jobInfo1.TotalPages
+ "\n" + "Submitted: " + DateFormat.getDateTimeInstance().format(lpFileTime.toDate());
System.out.println(info);
}
/**
* @param args
*/
public static void main(String[] args) {
new Win32SpoolMonitor();
}
}