XtfGetAumid
패키지 정보 개체에서 지정한 인덱스에 있는 AUMID(Application User Model ID)를 가져옵니다.구문
매개 변수
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 함수를 사용하여 등록된 패키지의 전체 이름을 검색할 수도 있습니다. 패키지에 대한 자세한 내용은 Packaging을 참조하세요.
요구 사항
헤더: xtfapi.h 라이브러리: XtfApi.lib 지원 플랫폼: Windows(XBOX 콘솔 도구용)참고 항목
XTF Transport Errors (NDA topic)XtfRegisterPackage
XtfRegisterNetworkSharePackage
Additional Xtf APIs