DeleteAppContainerProfile-Funktion (userenv.h)

Löscht das angegebene Profil pro Benutzer und Pro App.

Hinweis Das Löschen eines nicht vorhandenen Profils gibt einen Erfolg zurück.

 

Syntax

USERENVAPI HRESULT DeleteAppContainerProfile(
  [in] PCWSTR pszAppContainerName
);

Parameter

[in] pszAppContainerName

Der Name, der dem Profil beim Aufruf der CreateAppContainerProfile-Funktion zugewiesen wurde. Diese Zeichenfolge ist höchstens 64 Zeichen lang und passt in das Muster, das durch den regulären Ausdruck "[-_. A-Za-z0-9]+".

Rückgabewert

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

Rückgabecode	Beschreibung
HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED)	Wenn die -Methode aus einem App-Container aufgerufen wird.
S_OK	Das Profil wurde erfolgreich gelöscht.
E_INVALIDARG	Wenn der Containername NULL ist, oder wenn er den angegebenen Grenzwert für die Länge überschreitet.

Hinweise

Um die besten Ergebnisse zu erzielen, schließen Sie alle Dateihandles in den Profilspeicherorten, bevor Sie die DeleteAppContainerProfile-Funktion aufrufen. Andernfalls kann diese Funktion die Speicherorte für das Profil möglicherweise nicht vollständig entfernen.

Diese Funktion löscht das Profil für den aktuellen Benutzer. Um das Profil für einen anderen Benutzer zu löschen, müssen Sie die Identität dieses Benutzers annehmen.

Wenn die Funktion fehlschlägt, ist die status des Profils nicht festgelegt, und Sie sollten DeleteAppContainerProfile erneut aufrufen, um den Vorgang abzuschließen.

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

CreateAppContainerProfile