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 |