Condividi tramite


Funzione DeleteAppContainerProfile (userenv.h)

Elimina il profilo specificato per utente, per app.

Nota L'eliminazione di un profilo inesistente restituisce l'esito positivo.

 

Sintassi

USERENVAPI HRESULT DeleteAppContainerProfile(
  [in] PCWSTR pszAppContainerName
);

Parametri

[in] pszAppContainerName

Nome assegnato al profilo nella chiamata alla funzione CreateAppContainerProfile . Questa stringa ha una lunghezza massima di 64 caratteri e rientra nel criterio descritto dall'espressione regolare "[-_. A-Za-z0-9]+".

Valore restituito

Se questa funzione ha esito positivo, restituisce un codice HRESULT standard, incluso quanto segue:

Codice restituito Descrizione
HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED)
Se il metodo viene chiamato dall'interno di un contenitore di app.
S_OK
Il profilo è stato eliminato correttamente.
E_INVALIDARG
Se il nome del contenitore è NULL o se supera il limite specificato per la lunghezza.

Commenti

Per garantire i risultati migliori, chiudere tutti gli handle di file nei percorsi di archiviazione del profilo prima di chiamare la funzione DeleteAppContainerProfile . In caso contrario, questa funzione potrebbe non essere in grado di rimuovere completamente i percorsi di archiviazione per il profilo.

Questa funzione elimina il profilo per l'utente corrente. Per eliminare il profilo per un altro utente, è necessario rappresentare tale utente.

Se la funzione ha esito negativo, lo stato del profilo non è definito ed è necessario chiamare nuovamente DeleteAppContainerProfile per completare l'operazione.

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

Vedi anche

CreateAppContainerProfile