Funzione CredDeleteA (wincred.h)
La funzione CredDelete elimina una credenziale dal set di credenziali dell'utente. Il set di credenziali usato è quello associato alla sessione di accesso del token corrente. Il token non deve avere il SID dell'utente disabilitato.
Sintassi
BOOL CredDeleteA(
[in] LPCSTR TargetName,
[in] DWORD Type,
[in] DWORD Flags
);
Parametri
[in] TargetName
Puntatore a una stringa con terminazione Null contenente il nome della credenziale da eliminare.
[in] Type
Tipo di credenziale da eliminare. Deve essere uno dei tipi definiti CRED_TYPE_*. Per un elenco dei tipi definiti, vedere il membro Type della struttura CREDENTIAL .
Se il valore di questo parametro è CRED_TYPE_DOMAIN_EXTENDED, questa funzione può eliminare una credenziale che specifica un nome utente quando sono presenti più credenziali per la stessa destinazione. Il valore del parametro TargetName deve specificare il nome utente come Target|UserName.
[in] Flags
Riservato e deve essere zero.
Valore restituito
La funzione restituisce TRUE in caso di esito positivo e FALSE in caso di errore. È possibile chiamare la funzione GetLastError per ottenere un codice di stato più specifico. È possibile restituire i codici di stato seguenti:
- ERROR_NOT_FOUND
Nessuna credenziale con targetName specificato.
- ERROR_NO_SUCH_LOGON_SESSION
La sessione di accesso non esiste o non esiste alcun set di credenziali associato a questa sessione di accesso. Le sessioni di accesso di rete non hanno un set di credenziali associato.
- ERROR_INVALID_FLAGS
È stato specificato un flag non valido per il parametro Flags .
Commenti
Nota
L'intestazione wincred.h definisce CredDelete 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 che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.
Requisiti
Requisito | Valore |
---|---|
Client minimo supportato | Windows XP [solo app desktop] |
Server minimo supportato | Windows Server 2003 [solo app desktop] |
Piattaforma di destinazione | Windows |
Intestazione | wincred.h |
Libreria | Advapi32.lib |
DLL | Advapi32.dll |
Commenti e suggerimenti
https://aka.ms/ContentUserFeedback.
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedereInvia e visualizza il feedback per