Fungsi ParseApplicationUserModelId (appmodel.h)

Artikel
03/14/2023

Mendekonstruksi ID model pengguna aplikasi ke nama keluarga paket dan ID aplikasi relatif paket (PRAID).

Sintaks

LONG ParseApplicationUserModelId(
  [in]            PCWSTR applicationUserModelId,
  [in, out]       UINT32 *packageFamilyNameLength,
  [out, optional] PWSTR  packageFamilyName,
  [in, out]       UINT32 *packageRelativeApplicationIdLength,
  [out, optional] PWSTR  packageRelativeApplicationId
);

Parameter

[in] applicationUserModelId

Jenis: PCWSTR

ID model pengguna aplikasi.

[in, out] packageFamilyNameLength

Jenis: UINT32*

Penunjuk ke variabel yang menyimpan jumlah karakter (WCHARs) dalam string nama keluarga paket, yang mencakup null-terminator.

Pertama Anda meneruskan NULL ke packageFamilyName untuk mendapatkan jumlah karakter. Anda menggunakan nomor ini untuk mengalokasikan ruang memori untuk packageFamilyName. Kemudian Anda meneruskan alamat ruang memori ini untuk mengisi packageFamilyName.

[out, optional] packageFamilyName

Jenis: PWSTR

Pointer ke ruang memori yang menerima string nama keluarga paket, yang mencakup null-terminator.

[in, out] packageRelativeApplicationIdLength

Jenis: UINT32*

Penunjuk ke variabel yang menyimpan jumlah karakter (WCHARs) dalam string ID aplikasi relatif paket, yang mencakup null-terminator.

Pertama Anda meneruskan NULL ke packageRelativeApplicationId untuk mendapatkan jumlah karakter. Anda menggunakan nomor ini untuk mengalokasikan ruang memori untuk packageRelativeApplicationId. Kemudian Anda meneruskan alamat ruang memori ini untuk mengisi packageRelativeApplicationId.

[out, optional] packageRelativeApplicationId

Jenis: PWSTR

Penunjuk ke ruang memori yang menerima string ID aplikasi relatif paket (PRAID), yang mencakup terminator null.

Menampilkan nilai

Jenis: LONG

Jika fungsi berhasil, fungsi akan mengembalikan ERROR_SUCCESS. Jika tidak, fungsi mengembalikan kode kesalahan. Kode kesalahan yang mungkin mencakup yang berikut ini.

Menampilkan kode	Deskripsi
ERROR_INVALID_PARAMETER	Parameter applicationUserModelId tidak valid.
ERROR_INSUFFICIENT_BUFFER	Buffer yang ditentukan oleh packageFamilyName atau packageRelativeApplicationId tidak cukup besar untuk menyimpan data; ukuran buffer yang diperlukan, dalam WCHARs, disimpan dalam variabel yang ditunjukkan oleh packageFamilyNameLength atau packageRelativeApplicationIdLength.

Persyaratan


Klien minimum yang didukung	Windows 8.1 [aplikasi desktop \| Aplikasi UWP]
Server minimum yang didukung	Windows Server 2012 R2 [aplikasi desktop \| Aplikasi UWP]
Target Platform	Windows
Header	appmodel.h
Pustaka	Kernel32.lib
DLL	Kernel32.dll

Bagikan melalui