(ntifs.h) rtlQueryPackageIdentity 函数

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 及更高版本上使用
Header ntifs.h

另请参阅

RtlQueryPackageIdentityEx