Fungsi FormatApplicationUserModelId (appmodel.h)

  • Artikel

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