Funzione CreateAppContainerProfile (userenv.h)
Crea un profilo per utente per app per app per un oggetto AppContainer.
Sintassi
USERENVAPI HRESULT CreateAppContainerProfile(
[in] PCWSTR pszAppContainerName,
[in] PCWSTR pszDisplayName,
[in] PCWSTR pszDescription,
[in] PSID_AND_ATTRIBUTES pCapabilities,
[in] DWORD dwCapabilityCount,
[out] PSID *ppSidAppContainerSid
);
Parametri
[in] pszAppContainerName
Nome del contenitore dell'app. Per garantire l'univocità, questa stringa deve idealmente contenere il nome dell'app e il server di pubblicazione. Questa stringa può contenere fino a 64 caratteri. Inoltre, deve rientrare nel criterio descritto dall'espressione regolare "[-_. A-Za-z0-9]+".
[in] pszDisplayName
Nome visualizzato. Questa stringa può contenere fino a 512 caratteri.
[in] pszDescription
Descrizione del contenitore dell'app. Questa stringa può contenere fino a 2048 caratteri.
[in] pCapabilities
SID che definiscono le funzionalità UWP richieste (se applicabile).
[in] dwCapabilityCount
Numero di SID in pCapabilities.
[out] ppSidAppContainerSid
SID per il profilo. Questo buffer deve essere liberato usando la funzione FreeSid.
Valore restituito
Se questa funzione ha esito positivo, restituisce un codice HRESULT standard, incluso quanto segue:
| Codice restituito | Descrizione |
|---|---|
|
L'archivio dati è stato creato correttamente. |
|
Il chiamante non dispone dell'autorizzazione per creare il profilo. |
|
L'archivio dati dell'applicazione esiste già. |
|
Il nome del contenitore è NULL o il nome del contenitore, il nome visualizzato o le stringhe di descrizione superano i rispettivi limiti specificati per la lunghezza. |
Commenti
Un profilo contiene cartelle e archiviazione del Registro di sistema che sono per utente e per app. Le cartelle hanno elenchi di controllo di accesso che impediscono l'accesso da parte di altri utenti e app. È possibile accedere a queste cartelle chiamando SHGetKnownFolderPath.
La funzione crea un profilo per l'utente corrente. Per creare un profilo per conto di un altro utente, è necessario rappresentare tale utente. Per creare profili per più utenti della stessa app, è necessario chiamare CreateAppContainerProfile per ogni utente.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 8 [solo app desktop] |
| Server minimo supportato | Windows Server 2012 [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | userenv.h |
| Libreria | Userenv.lib |
| DLL | Userenv.dll |