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 フラグを受け取る値へのポインター。 Packaged は省略可能であり、 NULL にすることができます。

戻り値

RtlQueryPackageIdentity は、正常に完了するとSTATUS_SUCCESSを返します。それ以外の場合は、次のいずれかのコードが返されます。

エラー コード	意味
STATUS_INVALID_PARAMETER	パラメーターに無効な値が含まれています。たとえば、NULL 以外のバッファーにサイズ値が指定されていませんでした。 これはエラー コードです。
STATUS_NOT_FOUND	パッケージ ID が存在しません。

要件

要件	値
サポートされている最小のクライアント	Windows 8
Header	ntifs.h

こちらもご覧ください

RtlQueryPackageIdentityEx