> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XtfGetAumid

> XtfGetAumid

# XtfGetAumid

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

## Syntax

```cpp theme={null}
HRESULT XtfGetAumid(
         XtfPackageInfo packageInfo,
         UINT32 aumidIndex,
         PWSTR aumid,
         UINT32 *aumidBufferLength
)  
```

### Parameters

*packageInfo*\
型: XtfPackageInfo

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

*aumidIndex*\
型: UINT32

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

*aumid*\
型: PWSTR

\[out, optional] パッケージについて `aumidIndex` で指定されたインデックスの AUMID です。

*aumidBufferLength*\
型: UINT32 \*

\[in, out] `aumid` に割り当てられた長さ (**WCHAR** 単位) です。

### Return value

型: HRESULT

成功した場合は `S_OK` を返します。`aumid` の長さが足りない場合、この関数は `HRESULT_FROM_WIN32(ERROR_MORE_DATA)` を返し、必要なバッファーの長さが `aumidBufferLength` に返されます。

## Remarks

この関数を使用して、登録済みパッケージの情報オブジェクトから `aumidIndex` で指定したインデックスの AUMID を取得します。パッケージ情報オブジェクトへのポインターは、パッケージを登録するために [XtfRegisterPackage](https://docs.xbox.com/ja-jp/reference/tools/xtf/xtfapi/functions/xtfregisterpackage-xtfapi-xbox-windows-m.md) または [XtfRegisterNetworkSharePackage](https://docs.xbox.com/ja-jp/reference/tools/xtf/xtfapi/functions/xtfregisternetworksharepackage-xtfapi-xbox-windows-m.md) 関数を呼び出すことで返されます。

この関数を呼び出す前に、[XtfGetcountofAppUserModelIds](https://docs.xbox.com/ja-jp/reference/tools/xtf/xtfapi/functions/xtfgetcountofappusermodelids-xtfapi-xbox-windows-m.md) 関数を使用してパッケージ内の AUMID の数を取得してください。`XtfGetcountofAppUserModelIds` から返された値以上の値を `aumidIndex` に指定するとエラーが発生します。同様に、`aumidIndex` で指定されたインデックスに取得できるデータがない場合もエラーが発生します。

また、[XtfGetPackageFullName](https://docs.xbox.com/ja-jp/reference/tools/xtf/xtfapi/functions/xtfgetpackagefullname-xtfapi-xbox-windows-m.md) 関数を使用して、登録済みパッケージのフル ネームを取得することもできます。パッケージの詳細については、[Packaging](https://docs.xbox.com/ja-jp/build/core-features/common/packaging/gc-packaging-toc.md) を参照してください。

## Requirements

**ヘッダー:** xtfapi.h

**ライブラリ:** XtfApi.lib

**サポートされているプラットフォーム:** Windows (XBOX コンソール ツール用)

## See also

[XTF Transport Errors (NDA topic)](https://docs.xbox.com/ja-jp/tools/tools-console/commandlinetools/xtf-transport-errors.md)\
[XtfRegisterPackage](https://docs.xbox.com/ja-jp/reference/tools/xtf/xtfapi/functions/xtfregisterpackage-xtfapi-xbox-windows-m.md)\
[XtfRegisterNetworkSharePackage](https://docs.xbox.com/ja-jp/reference/tools/xtf/xtfapi/functions/xtfregisternetworksharepackage-xtfapi-xbox-windows-m.md)\
[Additional Xtf APIs](https://docs.xbox.com/ja-jp/reference/tools/xtf/xtfapi/atoc-xtfapi.md)


## Related topics

- [XtfGetTitleOSState](https://docs.xbox.com/ja-jp/reference/tools/xtf/xtfapi/functions/xtfgettitleosstate-xtfapi-xbox-windows-m.md)
- [XtfGetTitleOSFourPartVersion](https://docs.xbox.com/ja-jp/reference/tools/xtf/xtfapi/functions/xtfgettitleosfourpartversion-xtfapi-xbox-windows-m.md)
- [XtfGetCountofAppUserModelIds](https://docs.xbox.com/ja-jp/reference/tools/xtf/xtfapi/functions/xtfgetcountofappusermodelids-xtfapi-xbox-windows-m.md)
- [XtfRegisterNetworkSharePackage](https://docs.xbox.com/ja-jp/reference/tools/xtf/xtfapi/functions/xtfregisternetworksharepackage-xtfapi-xbox-windows-m.md)
- [XtfGetPackageFullName](https://docs.xbox.com/ja-jp/reference/tools/xtf/xtfapi/functions/xtfgetpackagefullname-xtfapi-xbox-windows-m.md)