Funzione CredDeleteW (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 CredDeleteW(
  [in] LPCWSTR 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 TargetUserName.

[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

  Non esiste alcuna credenziale con l'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 alla rete non hanno un set di credenziali associato.

• ERROR_INVALID_FLAGS

  Flag non valido specificato per il parametro flag .

Osservazioni

Fabbisogno