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。 如果 AppIdNULLAppIdSize 必须指向有效值;否则,AppIdSize 应设置为 NULL

Packaged

指向接收布尔标志的值的指针,该值指示应用程序是否打包。 打包 是可选的,可以 NULL

返回值

RtlQueryPackageIdentity 成功完成后返回STATUS_SUCCESS;否则,它将返回如下代码之一。

错误代码 意义
STATUS_INVALID_PARAMETER 参数包含无效值;例如,未为非 NULL 缓冲区提供大小值。 这是一个错误代码。
STATUS_NOT_FOUND 包标识不存在。

要求

要求 价值
最低支持的客户端 Windows 8
标头 ntifs.h

另请参阅

RtlQueryPackageIdentityEx