다음을 통해 공유

XtfGetAumid

  • 아티클

패키지 정보 개체의 지정된 인덱스에서 AUMID(애플리케이션 모델 사용자 ID)를 가져옵니다.

구문

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] aumid에 대해 할당된 WCHAR의 길이입니다.

반환 값

형식: HRESULT

성공하면 S_OK(이)가 반환됩니다. aumid(이)가 충분히 크지 않은 경우 이 함수는 HRESULT_FROM_WIN32(ERROR_MORE_DATA)를 반환하고 요구되는 버퍼 길이는 aumidBufferLength에서 반환됩니다.

비고

등록된 패키지에 대한 정보 개체에서 aumidIndex에 지정된 인덱스로 AUMID를 가져오려면 이 함수를 사용합니다. 패키지 정보 개체에 대한 포인터는 XtfRegisterPackage 또는 XtfRegisterNetworkSharePackage 함수를 호출하여 패키지를 등록하면 반환됩니다.

이 함수를 호출하기 전에 XtfGetcountofAppUserModelIds 함수를 사용하여 패키지에 대한 AUMID의 수를 가져옵니다. aumidIndex의 값을 XtfGetcountofAppUserModelIds에서 반환하는 값 이상으로 지정하는 경우 오류가 발생합니다. 마찬가지로 aumidIndex에 지정된 인덱스로 검색할 데이터가 없는 경우에도 오류가 발생합니다.

등록된 패키지의 전체 이름을 검색하려면 XtfGetPackageFullName 함수를 사용할 수도 있습니다. 패키지에 관한 자세한 내용은 패키징을 참조하세요.

요구 사항

헤더: xtfapi.h

라이브러리: XtfApi.lib

지원되는 플랫폼: Windows(Xbox 콘솔 도구용)

참고 항목

XTF 전송 오류(NDA 항목)
XtfRegisterPackage
XtfRegisterNetworkSharePackage
추가 Xtf API