XtfGetAumid
Obtém a ID do modelo de usuário do aplicativo (AUMID) no índice especificado de um objeto de informações do pacote.Sintaxe
Parâmetros
packageInfoTipo: XtfPackageInfo [in] O ponteiro para o objeto de informações de um pacote. aumidIndex
Tipo: UINT32 [in] Índice da AUMID no pacote. aumid
Tipo: PWSTR [out, optional] A AUMID do pacote no índice especificado em
aumidIndex.
aumidBufferLengthTipo: UINT32 * [in, out] O comprimento, em WCHAR, alocado para
aumid.
Valor de retorno
Tipo: HRESULT RetornaS_OK se tiver êxito. Se aumid não for grande o suficiente, esta função retornará HRESULT_FROM_WIN32(ERROR_MORE_DATA) e o comprimento de buffer necessário será retornado em aumidBufferLength.
Comentários
Use esta função para obter a AUMID no índice especificado emaumidIndex do objeto de informações de um pacote registrado. Um ponteiro para um objeto de informações do pacote é retornado ao chamar a função XtfRegisterPackage ou XtfRegisterNetworkSharePackage para registrar um pacote.
Antes de chamar esta função, use a função XtfGetcountofAppUserModelIds para obter a contagem de AUMIDs do pacote. Se você especificar em aumidIndex um valor igual ou maior que o valor retornado por XtfGetcountofAppUserModelIds, ocorrerá um erro. Da mesma forma, ocorrerá um erro se não houver dados a serem recuperados no índice especificado em aumidIndex.
Você também pode usar a função XtfGetPackageFullName para recuperar o nome completo de um pacote registrado. Para obter mais informações sobre pacotes, confira Empacotamento.
Requisitos
Cabeçalho: xtfapi.h Biblioteca: XtfApi.lib Plataformas com suporte: Windows (para ferramentas de console XBOX)Confira também
Erros de transporte do XTF (tópico sob NDA)XtfRegisterPackage
XtfRegisterNetworkSharePackage
APIs adicionais do Xtf