getPackageId 函式 (appmodel.h)

取得指定進程的封裝標識碼 (識別碼) 。

語法

LONG GetPackageId(
  [in]            HANDLE hProcess,
  [in, out]       UINT32 *bufferLength,
  [out, optional] BYTE   *buffer
);

[in] hProcess

類型： HANDLE

具有 PROCESS_QUERY_INFORMATION 或 PROCESS_QUERY_LIMITED_INFORMATION 訪問許可權之進程的句柄。如需詳細資訊，請參閱處理安全性和訪問許可權。

[in, out] bufferLength

類型： UINT32*

在輸入時， 緩衝區的大小，以位元組為單位。輸出時，傳回的結構大小，以位元組為單位。

[out, optional] buffer

類型： BYTE*

封裝標識碼，表示為 PACKAGE_ID 結構。

類型： LONG

如果函式成功，它會傳回 ERROR_SUCCESS。否則，函式會傳回錯誤碼。可能的錯誤碼包括下列專案。

傳回碼	Description
APPMODEL_ERROR_NO_PACKAGE	進程沒有套件身分識別。
ERROR_INSUFFICIENT_BUFFER	緩衝區不夠大，無法保存數據。所需的大小是由 bufferLength 指定。