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
指向接收布尔标志的值的指针,该值指示应用程序是否打包。 打包 是可选的,可以 NULL。
返回值
RtlQueryPackageIdentity 成功完成后返回STATUS_SUCCESS;否则,它将返回如下代码之一。
错误代码 | 意义 |
---|---|
STATUS_INVALID_PARAMETER | 参数包含无效值;例如,未为非 NULL 缓冲区提供大小值。 这是一个错误代码。 |
STATUS_NOT_FOUND | 包标识不存在。 |
要求
要求 | 价值 |
---|---|
最低支持的客户端 | Windows 8 |
标头 | ntifs.h |