使用 JNA 获取/设置应用程序标识符

Question

跟进我之前有关 Windows 7 任务栏的问题，我想诊断为什么 Windows 不承认我的应用程序独立于 javaw.exe。我目前有以下 JNA 代码来获取 AppUserModelID：

public class AppIdTest {

    public static void main(String[] args) {
        NativeLibrary lib;
        try {
            lib = NativeLibrary.getInstance("shell32");
        } catch (Error e) {
            System.err.println("Could not load Shell32 library.");
            return;
        }
        Object[] functionArgs = new Object[1];
        String functionName = null;
        Function function;
        try {
            functionArgs[0] = new String("Vendor.MyJavaApplication")
                    .getBytes("UTF-16");
            functionName = "GetCurrentProcessExplicitAppUserModelID";
            function = lib.getFunction(functionName);
            // Output the current AppId
            System.out.println("1: " + function.getString(0));
            functionName = "SetCurrentProcessExplicitAppUserModelID";
            function = lib.getFunction(functionName);
            // Set the new AppId
            int ret = function.invokeInt(functionArgs);
            if (ret != 0) {
                Logger.out.error(function.getName() + " returned error code "
                        + ret + ".");
            }
            functionName = "GetCurrentProcessExplicitAppUserModelID";
            function = lib.getFunction(functionName);
            // Output the current AppId
            System.out.println("2: " + function.getString(0));
            // Output the current AppID, converted from UTF-16
            System.out.println("3: "
                    + new String(function.getByteArray(0, 255), "UTF-16"));
        } catch (UnsupportedEncodingException e) {
            System.err.println("System does not support UTF-16 encoding.");
        } catch (UnsatisfiedLinkError e) {
            System.err.println(functionName + " was not found in "
                    + lib.getFile().getName() + ".");
        }
    }
}

应用程序的输出看似乱码：

1: ‹ÿU‹ìƒìL¡¬Ÿv3ʼnEüSV‹uƒ&
2: ‹ÿU‹ìƒìL¡¬Ÿv3ʼnEüSV‹uƒ&
3: ????????????????P???????????

意识到输出可能是 UTF-16，在 (3) 中我尝试将字节数组从 UTF-16 转换。老实说，我不知道我的方法是否正确，因为（a）我不知道 PWSTR 的大小，（b）我不知道 GetCurrentProcessExplicitAppUserModelID 确实返回一个字节数组或字符串。

我知道 JSmooth 会在模拟这种效果的包装器中运行 GUI 进程。 Launch4j 声称可以做同样的事情，但似乎不起作用。我希望设置 AppUserModelID，无论 Java 包装器如何。

这里出了什么问题？

Answer 1

以下是有关如何通过 JNA 调用 SetCurrentProcessExplicitAppUserModelID 的更简单示例：

import com.sun.jna.*;
import com.sun.jna.win32.*;

interface Shell32 extends StdCallLibrary {

    Shell32 INSTANCE = (Shell32) Native.loadLibrary("shell32", Shell32.class, W32APIOptions.DEFAULT_OPTIONS);

    NativeLong SetCurrentProcessExplicitAppUserModelID(WString appID);

}

Answer 2

我之前没有看到你的问题，否则即使没有赏金我也会尝试一下。

这是我想出的。 请注意，正如代码本身所述，我没有使用 CoTaskMemFree 函数（来自 Ole32.dll）实现正确的内存清理。因此，我建议您仅采用 SetCurrentProcessExplicitAppUserModelID() 的实现，

package com.stackoverflow.AppIdTest;

import com.sun.jna.Native;
import com.sun.jna.NativeLong;
import com.sun.jna.Pointer;
import com.sun.jna.WString;
import com.sun.jna.ptr.PointerByReference;

public class AppIdTest
{

  public static void main(String[] args) throws Exception
  {
    setCurrentProcessExplicitAppUserModelID(AppIdTest.class.getName());

    System.out.println(getCurrentProcessExplicitAppUserModelID());
  }

  // DO NOT DO THIS, IT'S JUST FOR TESTING PURPOSE AS I'M NOT FREEING THE MEMORY
  // AS REQUESTED BY THE DOCUMENTATION:
  //
  // http://msdn.microsoft.com/en-us/library/dd378419%28VS.85%29.aspx
  //
  // "The caller is responsible for freeing this string with CoTaskMemFree when
  // it is no longer needed"
  public static String getCurrentProcessExplicitAppUserModelID()
  {
    final PointerByReference r = new PointerByReference();

    if (GetCurrentProcessExplicitAppUserModelID(r).longValue() == 0)
    {
      final Pointer p = r.getValue();


      return p.getString(0, true); // here we leak native memory by lazyness
    }      
    return "N/A";
  }

  public static void setCurrentProcessExplicitAppUserModelID(final String appID)
  {
    if (SetCurrentProcessExplicitAppUserModelID(new WString(appID)).longValue() != 0)
      throw new RuntimeException("unable to set current process explicit AppUserModelID to: " + appID);
  }

  private static native NativeLong GetCurrentProcessExplicitAppUserModelID(PointerByReference appID);
  private static native NativeLong SetCurrentProcessExplicitAppUserModelID(WString appID);


  static
  {
    Native.register("shell32");
  }
}

它适合您吗？

至少在这里它正确地打印回来：

com.stackoverflow.AppIdTest.AppIdTest

Answer 3

如果您只需要设置 AppUserModelId 那么上面的 JNA 代码就足够了。但是，如果您想在 Java 应用程序中利用 Windows 7 的新功能，请查看 J7Goodies 的功能，一个提供 Windows 7 任务栏扩展的 Java 库。

---

编辑：来自 J7Goodies 程序员指南的更多信息

4.2。设置AppUserModelID

为了使用任何 Windows 7 功能，应用程序必须明确
设置其进程标识符 –
应用程序用户模型 ID (AppUserModelID)。它不能超过
128 个字符，不能包含空格。每个部分应该是
驼峰式，例如：

 公司名称.产品名称.子产品.版本信息

该标识符
必须在显示任何 GUI（窗口）之前设置。您可以通过调用来设置它：

// Remember to set AppUserModelID before creating any UI
AppUserModelId.setCurrentProcessId("StrixCode.J7Goodies.Appname");

4.3。设置窗口属性

除非定义了 Java 应用程序的窗口属性，否则无法将其固定到 Windows 7 任务栏。这
属性由四个字段组成：

• AppUserModelID – 与传递给 AppUserModelId.setCurrentProcessId(String) 的内容相同
• RelaunchDisplayName – 应用程序名称
• RelaunchCommand – 用于启动应用程序的完整命令。如果是 Java 程序，则为：-jar <应用程序 jar 的路径>
• RelaunchIcon – 应用程序图标的路径

重要：必须始终设置 RelaunchCommand 和 RelaunchDisplayName
一起。要设置这些属性，请使用简单的 WindowProperties 类。

WindowProperties props = new WindowProperties(myFrame);
props.setRelaunchCommand("<full path to javaw.exe –arguments>");
props.setRelaunchDisplayName("My Java Application");
props.setRelaunchIcon("<full path to an .ico or .exe file>");
props.setAppUserModelID("StrixCode.J7Goodies.Appname");
props.save();