Condividi tramite

Funzione DeleteProfileA (userenv.h)

  • Articolo

Elimina il profilo utente e tutte le impostazioni correlate all'utente dal computer specificato. Il chiamante deve disporre di privilegi amministrativi per eliminare il profilo di un utente.

Sintassi

USERENVAPI BOOL DeleteProfileA(
  [in]           LPCSTR lpSidString,
  [in, optional] LPCSTR lpProfilePath,
  [in, optional] LPCSTR lpComputerName
);

Parametri

[in] lpSidString

Tipo: LPCTSTR

Puntatore a una stringa che specifica l'utente SID.

[in, optional] lpProfilePath

Tipo: LPCTSTR

Puntatore a una stringa che specifica il percorso del profilo. Se questo parametro è NULL, la funzione ottiene il percorso dal Registro di sistema.

[in, optional] lpComputerName

Tipo: LPCTSTR

Puntatore a una stringa che specifica il nome del computer da cui deve essere eliminato il profilo. Se questo parametro è NULL, viene usato il nome del computer locale.

Nota A partire da Windows Vista, questo parametro deve essere NULL. In caso contrario, questa funzione ha esito negativo con il codice di errore ERROR_INVALID_PARAMETER.
 

Valore restituito

Tipo: bool

true se ha esito positivo; in caso contrario, FALSE. Per ottenere informazioni estese sull'errore, chiamare GetLastError.

Osservazioni

deleteProfile potrebbe non riuscire quando viene passato l'identificatore di sicurezza (SID) dell'account di sistema locale (S-1-5-18).

Nota

L'intestazione userenv.h definisce DeleteProfile come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito Valore
client minimo supportato Windows 2000 Professional [solo app desktop]
server minimo supportato Windows 2000 Server [solo app desktop]
piattaforma di destinazione Finestre
intestazione userenv.h
libreria Userenv.lib
dll Userenv.dll

Vedere anche

Panoramica dei profili utente

riferimento ai profili utente