RtlQueryPackageIdentityEx 函式 (ntifs.h)

  • 發行項

RtlQueryPackageIdentityEx 會傳回相關聯的完整套件名稱。 它也可以選擇性地傳回套件相對應用程式名稱，以及應用程式是否被視為已封裝。

語法

NTSYSAPI NTSTATUS RtlQueryPackageIdentityEx(
  PVOID    TokenObject,
  PWSTR    PackageFullName,
  PSIZE_T  PackageSize,
  PWSTR    AppId,
  PSIZE_T  AppIdSize,
  LPGUID   DynamicId,
  PULONG64 Flags
);

參數

TokenObject

處理以TOKEN_QUERY存取開啟的令牌物件 (使用者) 模式，或 (核心模式) 原始令牌物件) 。

PackageFullName

將接收唯一封裝密鑰之寬字元緩衝區的指標。 緩衝區會在成功時終止 Null。

PackageSize

值指標，定義 PackageFullName 所指向的緩衝區大小。 在輸出中，它會包含寫入的大小，包括終止 Null。

AppId

可接收封裝相對應用程式識別碼之寬字元緩衝區的指標。 AppId 是選擇性的，可以是 NULL。

AppIdSize

值指標，這個值定義 AppId 所指向的緩衝區大小。 在輸出中，它會包含寫入的大小，包括終止 Null。 如果 AppId 不是 NULL，AppIdSize 必須指向有效的值;否則 AppIdSize 應該設定為 NULL。

DynamicId

接收應用程式動態標識碼之值的指標。 DynamicId 是選擇性的，可以是 NULL。

Flags

值的指標，這個值會接收封裝屬性值的位掩碼。

傳回值

RtlQueryPackageIdentityEx 會在成功完成時傳回STATUS_SUCCESS;否則會傳回下列其中一個程序代碼。

錯誤碼 意義
STATUS_INVALID_PARAMETER 參數包含無效的值;例如，未針對非 NULL 緩衝區提供大小值。 這是錯誤碼。
STATUS_NOT_FOUND 套件身分識別不存在。

規格需求

需求 值
最低支援的用戶端 Windows 8.1
標頭 ntifs.h