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	パッケージ ID が存在しません。

必要条件

要件	価値
サポートされる最小クライアント	Windows 8
ヘッダー	ntifs.h

関連項目

RtlQueryPackageIdentityExの