RtlQueryPackageIdentityEx 関数 (ntifs.h)

RtlQueryPackageIdentityEx は 、関連付けられている完全なパッケージ名を返します。 必要に応じて、パッケージの相対アプリケーション名と、アプリケーションがパッケージ化されたものと見なされるかどうかを返すこともできます。

構文

NTSYSAPI NTSTATUS RtlQueryPackageIdentityEx(
  PVOID    TokenObject,
  PWSTR    PackageFullName,
  PSIZE_T  PackageSize,
  PWSTR    AppId,
  PSIZE_T  AppIdSize,
  LPGUID   DynamicId,
  PULONG64 Flags
);

パラメーター

TokenObject

TOKEN_QUERY アクセスで開かれたトークン オブジェクト (ユーザー モード) または未加工のトークン オブジェクト (カーネル モード) を処理します。

PackageFullName

一意のパッケージ キーを受け取るワイド文字バッファーへのポインター。 成功すると、バッファーは null で終了します。

PackageSize

PackageFullName が指すバッファーのサイズを定義する値へのポインター。 出力時には、終端の null を含む書き込みサイズが含まれます。

AppId

パッケージの相対アプリケーション識別子を受け取る可能性があるワイド文字バッファーへのポインター。 AppId は省略可能であり、 NULL にすることができます。

AppIdSize

AppId が指すバッファーのサイズを定義する値へのポインター。 出力時には、終端の null を含む書き込みサイズが含まれます。 AppId が NULL でない場合、AppIdSize は有効な値を指す必要があります。それ以外の場合、AppIdSize は NULL に設定する必要があります。

DynamicId

アプリケーションの動的 ID を受け取る値へのポインター。 DynamicId は省略可能であり、 NULL にすることができます。

Flags

パッケージ属性の値のビットマスクを受け取る値へのポインター。

戻り値

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

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

要件

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