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

# XtfGetAumid

> XtfGetAumid

# XtfGetAumid

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

<a id="syntaxSection" />

## Syntax

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

<a id="parametersSection" />

### Parameters

*packageInfo*\
型: XtfPackageInfo

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

*aumidIndex*\
型: UINT32

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

*aumid*\
型: PWSTR

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

*aumidBufferLength*\
型: UINT32 \*

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

<a id="retvalSection" />

### Return value

型: HRESULT

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

<a id="remarksSection" />

## Remarks

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

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

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

<a id="requirements" />

## Requirements

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

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

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

<a id="seealsoSection" />

## See also

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


## Related topics

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