Función GetAppContainerFolderPath (userenv.h)

  • Artículo

Obtiene la ruta de acceso de la carpeta de datos de la aplicación local para el contenedor de aplicaciones especificado.

Sintaxis

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

Parámetros

[in] pszAppContainerSid

Puntero al SID del contenedor de aplicaciones.

[out] ppszPath

La dirección de un puntero a una cadena que, cuando esta función vuelve correctamente, recibe la ruta de acceso de la carpeta local. Es responsabilidad del autor de la llamada liberar esta cadena cuando ya no es necesaria mediante una llamada a la función CoTaskMemFree .

Valor devuelto

Esta función devuelve un código HRESULT , incluido pero no limitado a lo siguiente:

Código devuelto Descripción
S_OK
 La operación se ha completado correctamente.
E_INVALIDARG
 El parámetro pszAppContainerSid o ppszPath es NULL.

Comentarios

La ruta de acceso recuperada a través de esta función es la misma ruta de acceso que obtendría llamando a la función SHGetKnownFolderPath con FOLDERID_LocalAppData.

Si se establece un token de subproceso, esta función usa el contenedor de aplicaciones para el usuario actual. Si no se establece ningún token de subproceso, esta función usa el contenedor de aplicaciones asociado a la identidad del proceso.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 8 [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2012 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado userenv.h
Library Userenv.lib
Archivo DLL Userenv.dll

Consulte también

GetAppContainerRegistryLocation