Funzione CredRenameW (wincred.h)

Articolo
11/20/2024

[ 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 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 di credenziale da rinominare. Deve essere uno dei CRED_TYPE_* definiti.

[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'OldTargetName.
ERROR_ALREADY_EXISTS
Esiste già una credenziale o un tipo 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 alla rete non hanno un set di credenziali associato.
ERROR_INVALID_FLAGS
Flag non valido specificato per il parametro flag .

Osservazioni

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 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 XP [solo app desktop]
server minimo supportato	Windows Server 2003 [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	wincred.h
libreria	Advapi32.lib
dll	Advapi32.dll

Condividi tramite