Funzione CredRenameA (wincred.h)

Articolo
03/08/2023

[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 il SID dell'utente disabilitato.

Sintassi

BOOL CredRenameA(
  [in] LPCSTR OldTargetName,
  [in] LPCSTR 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 di credenziale da rinominare. Deve essere una delle definizioni di CRED_TYPE_*.

[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. È 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'elemento 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
È stato specificato un 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 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

Condividi tramite