次の方法で共有

XtfGetAumid

  • [アーティクル]

パッケージの情報オブジェクトから、指定のインデックスのアプリケーション モデル ユーザー ID (AUMID) を取得します。

構文

HRESULT XtfGetAumid(
         XtfPackageInfo packageInfo,
         UINT32 aumidIndex,
         PWSTR aumid,
         UINT32 *aumidBufferLength
)

パラメーター

packageInfo
型: XtfPackageInfo

[in] パッケージの情報オブジェクトへのポインター。

aumidIndex
型: UINT32

[in] パッケージ内の AUMID のインデックス。

aumid
型: PWSTR

[out, optional] パッケージの aumidIndex で指定されたインデックスの AUMID。

aumidBufferLength
型: UINT32 *

[in, out] 長さ、WCHAR 内、aumid に割り当て。

戻り値

型: HRESULT

正常に実行された場合は、S_OK を返します。 aumid の大きさが十分ではない場合に、この関数は HRESULT_FROM_WIN32(ERROR_MORE_DATA) を返し、必要なバッファーの長さが aumidBufferLength で返されます。

解説

この関数を使用して、登録されているパッケージの情報オブジェクトから aumidIndex で指定されたインデックスの AUMID を取得します。 パッケージを登録するために XtfRegisterPackage または XtfRegisterNetworkSharePackage 関数を呼び出すことにより、パッケージ情報オブジェクトへのポインターが返されます。

この関数を呼び出す前に、XtfGetcountofAppUserModelIds 関数を使用してパッケージの AUMID のカウントを取得します。 XtfGetcountofAppUserModelIds によって返される値以上の値を aumidIndex に指定すると、エラーが発生します。 同様に、aumidIndex に指定されたインデックスで取得できるデータがない場合は、エラーが発生します。

XtfGetPackageFullName 関数を使用して、登録されているパッケージの完全名を取得することもできます。 パッケージの詳細については、「パッケージ化」を参照してください。

要件

ヘッダー: xtfapi.h

ライブラリ: XtfApi.lib

サポートされているプラットフォーム: Windows (Xbox 本体ツール用)

関連項目

XTF トランスポート エラー (NDA トピック)
XtfRegisterPackage
XtfRegisterNetworkSharePackage
その他の Xtf API