Fungsi FormatApplicationUserModelId (appmodel.h)

Membuat ID model pengguna aplikasi dari nama keluarga paket dan ID aplikasi relatif paket (PRAID).

Sintaks

LONG FormatApplicationUserModelId(
  [in]            PCWSTR packageFamilyName,
  [in]            PCWSTR packageRelativeApplicationId,
  [in, out]       UINT32 *applicationUserModelIdLength,
  [out, optional] PWSTR  applicationUserModelId
);

Parameter

[in] packageFamilyName

Jenis: PCWSTR

Nama keluarga paket.

[in] packageRelativeApplicationId

Jenis: PCWSTR

ID aplikasi relatif paket (PRAID).

[in, out] applicationUserModelIdLength

Jenis: UINT32*

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

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

[out, optional] applicationUserModelId

Jenis: PWSTR

Pointer ke ruang memori yang menerima string ID model pengguna aplikasi, yang mencakup null-terminator.

Nilai kembali

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 packageFamilyName atau packageRelativeApplicationId tidak valid.
ERROR_INSUFFICIENT_BUFFER	Buffer yang ditentukan oleh applicationUserModelId tidak cukup besar untuk menyimpan data; ukuran buffer yang diperlukan, dalam WCHARs, disimpan dalam variabel yang ditunjukkan oleh applicationUserModelIdLength.

Persyaratan

Persyaratan	Nilai
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