CreateAppContainerProfile-Funktion (userenv.h)

  • Artikel

Erstellt ein Pro-Benutzer-App-Profil für einen AppContainer.

Syntax

USERENVAPI HRESULT CreateAppContainerProfile(
  [in]  PCWSTR              pszAppContainerName,
  [in]  PCWSTR              pszDisplayName,
  [in]  PCWSTR              pszDescription,
  [in]  PSID_AND_ATTRIBUTES pCapabilities,
  [in]  DWORD               dwCapabilityCount,
  [out] PSID                *ppSidAppContainerSid
);

Parameter

[in] pszAppContainerName

Der Name des App-Containers. Um die Eindeutigkeit sicherzustellen, sollte diese Zeichenfolge idealerweise sowohl den App-Namen als auch den Herausgeber enthalten. Diese Zeichenfolge kann bis zu 64 Zeichen lang sein. Darüber hinaus muss es in das Muster passen, das durch den regulären Ausdruck "[-_. A-Za-z0-9]+".

[in] pszDisplayName

Neuer Anzeigename. Diese Zeichenfolge kann bis zu 512 Zeichen lang sein.

[in] pszDescription

Eine Beschreibung für den App-Container. Diese Zeichenfolge kann bis zu 2048 Zeichen lang sein.

[in] pCapabilities

Die SIDs, die die angeforderten UWP-Funktionen definieren (falls zutreffend).

[in] dwCapabilityCount

Die Anzahl der SIDs in pCapabilities.

[out] ppSidAppContainerSid

Die SID für das Profil. Dieser Puffer muss mithilfe der FreeSid-Funktionfreigegeben werden.

Rückgabewert

Wenn diese Funktion erfolgreich ist, gibt sie einen HRESULT-Standardcode zurück, einschließlich der folgenden:

Rückgabecode BESCHREIBUNG
S_OK
 Der Datenspeicher wurde erfolgreich erstellt.
E_ACCESSDENIED
 Der Aufrufer verfügt nicht über die Berechtigung zum Erstellen des Profils.
HRESULT_FROM_WIN32(ERROR_ALREADY_EXISTS)
 Der Anwendungsdatenspeicher ist bereits vorhanden.
E_INVALIDARG
 Der Containername ist NULL, oder der Containername, der Anzeigename oder die Beschreibungszeichenfolgen überschreiten die angegebenen Längengrenzwerte.

Hinweise

Ein Profil enthält Ordner und Registrierungsspeicher, die benutzer- und appbezogen sind. Die Ordner verfügen über ACLs, die verhindern, dass andere Benutzer und Apps darauf zugreifen. Auf diese Ordner kann durch Aufrufen von SHGetKnownFolderPath zugegriffen werden.

Die Funktion erstellt ein Profil für den aktuellen Benutzer. Um ein Profil im Namen eines anderen Benutzers zu erstellen, müssen Sie die Identität dieses Benutzers annehmen. Um Profile für mehrere Benutzer derselben App zu erstellen, müssen Sie CreateAppContainerProfile für jeden Benutzer aufrufen.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 8 [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2012 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile userenv.h
Bibliothek Userenv.lib
DLL Userenv.dll

Weitere Informationen