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 |