Funzione CredRenameW (wincred.h)

  • Articolo

[CredRename non è più supportato. A partire da Windows Vista, le chiamate a CredRename restituiscono sempre ERROR_NOT_SUPPORTED.]

La funzione CredRename rinomina una credenziale nel set di credenziali dell'utente. Il set di credenziali usato è quello associato alla sessione di accesso del token corrente. Il token non deve avere disabilitato il SID dell'utente.

Sintassi

BOOL CredRenameW(
  [in] LPCWSTR OldTargetName,
  [in] LPCWSTR NewTargetName,
  [in] DWORD   Type,
  [in] DWORD   Flags
);

Parametri

[in] OldTargetName

Puntatore a una stringa con terminazione null contenente il nome corrente della credenziale da rinominare.

[in] NewTargetName

Puntatore a una stringa con terminazione null contenente il nuovo nome per le credenziali.

[in] Type

Tipo delle credenziali da rinominare. Deve essere uno dei CRED_TYPE_* definisce.

[in] Flags

Flag per controllare l'operazione della funzione. Attualmente riservato e deve essere zero.

Valore restituito

La funzione restituisce TRUE in caso di esito positivo e FALSE in caso di errore. La funzione GetLastError può essere chiamata per ottenere un codice di stato più specifico. È possibile restituire i codici di stato seguenti:

  • ERROR_NOT_FOUND

    Non è presente alcuna credenziale con il nome OldTargetName specificato.

  • ERROR_ALREADY_EXISTS

    Esiste già una credenziale o un tipo e denominato NewTargetName.

  • 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

    Flag non valido per il parametro Flags .

Commenti

Nota

L'intestazione wincred.h definisce CredRename come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.

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