GetAppContainerFolderPath-Funktion (userenv.h)

  • Artikel

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
S_OK
 Der Vorgang wurde erfolgreich abgeschlossen.
E_INVALIDARG
 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

Weitere Informationen

GetAppContainerRegistryLocation