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 |
---|---|
|
L’opération s’est terminée avec succès. |
|
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 |