GetAppContainerFolderPath-Funktion (userenv.h)
Ruft den Pfad des lokalen App-Datenordners für den angegebenen App-Container ab.
Syntax
USERENVAPI HRESULT GetAppContainerFolderPath(
[in] PCWSTR pszAppContainerSid,
[out] PWSTR *ppszPath
);
Parameter
[in] pszAppContainerSid
Ein Zeiger auf die SID des App-Containers.
[out] ppszPath
Die Adresse eines Zeigers auf eine Zeichenfolge, die bei erfolgreicher Rückgabe dieser Funktion den Pfad des lokalen Ordners empfängt. Es liegt in der Verantwortung des Aufrufers, diese Zeichenfolge frei zu geben, wenn sie nicht mehr benötigt wird, indem die CoTaskMemFree-Funktion aufgerufen wird.
Rückgabewert
Diese Funktion gibt einen HRESULT-Code zurück, einschließlich, aber nicht beschränkt auf Folgendes:
| Rückgabecode | BESCHREIBUNG |
|---|---|
|
Der Vorgang wurde erfolgreich abgeschlossen. |
|
Der Parameter pszAppContainerSid oder ppszPath ist NULL. |
Hinweise
Der Pfad, der über diese Funktion abgerufen wird, ist derselbe Pfad, den Sie erhalten, wenn Sie die SHGetKnownFolderPath-Funktion mit FOLDERID_LocalAppData aufrufen.
Wenn ein Threadtoken festgelegt ist, verwendet diese Funktion den App-Container für den aktuellen Benutzer. Wenn kein Threadtoken festgelegt ist, verwendet diese Funktion den App-Container, der der Prozessidentität zugeordnet ist.
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 |