Partager via


GetAppContainerFolderPath, fonction (userenv.h)

Obtient le chemin d’accès du dossier de données d’application local pour le conteneur d’application spécifié.

Syntaxe

USERENVAPI HRESULT GetAppContainerFolderPath(
  [in]  PCWSTR pszAppContainerSid,
  [out] PWSTR  *ppszPath
);

Paramètres

[in] pszAppContainerSid

Pointeur vers le SID du conteneur d’application.

[out] ppszPath

Adresse d’un pointeur vers une chaîne qui, lorsque cette fonction retourne correctement, reçoit le chemin du dossier local. Il incombe à l’appelant de libérer cette chaîne quand elle n’est plus nécessaire en appelant la fonction CoTaskMemFree .

Valeur retournée

Cette fonction retourne un code HRESULT , y compris, mais sans s’y limiter, les éléments suivants :

Code de retour Description
S_OK
L’opération s’est terminée avec succès.
E_INVALIDARG
Le paramètre pszAppContainerSid ou ppszPath est NULL.

Remarques

Le chemin récupéré via cette fonction est le même que celui que vous obtiendriez en appelant la fonction SHGetKnownFolderPath avec FOLDERID_LocalAppData.

Si un jeton de thread est défini, cette fonction utilise le conteneur d’application pour l’utilisateur actuel. Si aucun jeton de thread n’est défini, cette fonction utilise le conteneur d’application associé à l’identité de processus.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 8 [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2012 [applications de bureau uniquement]
Plateforme cible Windows
En-tête userenv.h
Bibliothèque Userenv.lib
DLL Userenv.dll

Voir aussi

GetAppContainerRegistryLocation