ParseApplicationUserModelId-Funktion (appmodel.h)

  • Artikel

Dekonstruiert eine Anwendungsbenutzermodell-ID in den Paketfamiliennamen und die paketrelative Anwendungs-ID (PRAID).

Syntax

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

Parameter

[in] applicationUserModelId

Typ: PCWSTR

Die Id des App-Benutzermodells.

[in, out] packageFamilyNameLength

Typ: UINT32*

Ein Zeiger auf eine Variable, die die Anzahl von Zeichen (WCHARs) in der Paketfamiliennamenzeichenfolge enthält, die den NULL-Abschluss enthält.

Zuerst übergeben Sie NULL an packageFamilyName , um die Anzahl der Zeichen abzurufen. Sie verwenden diese Nummer, um Speicherplatz für packageFamilyName zuzuweisen. Anschließend übergeben Sie die Adresse dieses Speicherplatzes, um packageFamilyName zu füllen.

[out, optional] packageFamilyName

Typ: PWSTR

Ein Zeiger auf den Speicherplatz, der die Zeichenfolge des Paketfamiliennamens empfängt, die den NULL-Terminator enthält.

[in, out] packageRelativeApplicationIdLength

Typ: UINT32*

Ein Zeiger auf eine Variable, die die Anzahl von Zeichen (WCHARs) in der paketrelativen App-ID-Zeichenfolge enthält, die das NULL-Abschlusszeichen enthält.

Zuerst übergeben Sie NULL an packageRelativeApplicationId , um die Anzahl der Zeichen abzurufen. Sie verwenden diese Nummer, um Speicherplatz für packageRelativeApplicationId zuzuweisen. Anschließend übergeben Sie die Adresse dieses Speicherplatzes, um packageRelativeApplicationId zu füllen.

[out, optional] packageRelativeApplicationId

Typ: PWSTR

Ein Zeiger auf den Speicherplatz, der die PRAID-Zeichenfolge (Paketrelative App-ID) empfängt, die das NULL-Abschlusszeichen enthält.

Rückgabewert

Typ: LONG

Wenn die Funktion erfolgreich ist, gibt sie ERROR_SUCCESS zurück. Andernfalls gibt die Funktion einen Fehlercode zurück. Folgende Fehlercodes sind möglich.

Rückgabecode Beschreibung
ERROR_INVALID_PARAMETER
 Der ApplicationUserModelId-Parameter ist ungültig.
ERROR_INSUFFICIENT_BUFFER
 Der durch packageFamilyName oder packageRelativeApplicationId angegebene Puffer ist nicht groß genug, um die Daten aufzunehmen. Die erforderliche Puffergröße in WCHARs wird in der Variablen gespeichert, auf die von packageFamilyNameLength oder packageRelativeApplicationIdLength verwiesen wird.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows 8.1 [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows Server 2012 R2 [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile appmodel.h
Bibliothek Kernel32.lib
DLL Kernel32.dll