RtlQueryPackageIdentity 函式 (ntifs.h)
RtlQueryPackageIdentity 會傳回相關聯的完整套件名稱。 它也可以選擇性地傳回套件相對應用程式名稱,以及應用程式是否被視為已封裝。 另請參閱 RtlQueryPackageIdentityEx。
語法
NTSYSAPI NTSTATUS RtlQueryPackageIdentity(
PVOID TokenObject,
PWSTR PackageFullName,
PSIZE_T PackageSize,
PWSTR AppId,
PSIZE_T AppIdSize,
PBOOLEAN Packaged
);
參數
TokenObject
處理以TOKEN_QUERY存取開啟的令牌物件 (使用者) 模式,或 (核心模式) 原始令牌物件) 。
PackageFullName
將接收唯一封裝密鑰之寬字元緩衝區的指標。 緩衝區會在成功時終止 Null。
PackageSize
值指標,定義 PackageFullName 所指向的緩衝區大小。 在輸出中,它會包含寫入的大小,包括終止 Null。
AppId
可接收封裝相對應用程式識別碼之寬字元緩衝區的指標。 AppId 是選擇性的,可以是 NULL。
AppIdSize
值指標,這個值定義 AppId 所指向的緩衝區大小。 在輸出中,它會包含寫入的大小,包括終止 Null。 如果 AppId 不是 NULL,AppIdSize 必須指向有效的值;否則 AppIdSize 應該設定為 NULL。
Packaged
值指標,這個值會接收指出應用程式是否已封裝的 BOOLEAN 旗標。 封裝 是選擇性的,可以是 NULL。
傳回值
RtlQueryPackageIdentity 會在成功完成時傳回STATUS_SUCCESS;否則會傳回下列其中一個程序代碼。
錯誤碼 | 意義 |
---|---|
STATUS_INVALID_PARAMETER | 參數包含無效的值;例如,未針對非 NULL 緩衝區提供大小值。 這是錯誤碼。 |
STATUS_NOT_FOUND | 套件身分識別不存在。 |
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 8 |
標頭 | ntifs.h |