Funzione ChangeAccountPasswordA (sspi.h)
La funzione ChangeAccountPassword modifica la password per un account di dominio Windows usando il provider di supporto della sicurezza specificato.
Questa funzione è supportata solo dai provider Microsoft Kerberos, Microsoft Negotiate e Microsoft NTLM .
Sintassi
SECURITY_STATUS SEC_ENTRY ChangeAccountPasswordA(
[in] SEC_CHAR *pszPackageName,
[in] SEC_CHAR *pszDomainName,
[in] SEC_CHAR *pszAccountName,
[in] SEC_CHAR *pszOldPassword,
[in] SEC_CHAR *pszNewPassword,
[in] BOOLEAN bImpersonating,
[in] unsigned long dwReserved,
[in, out] PSecBufferDesc pOutput
);
Parametri
[in] pszPackageName
Nome del provider da usare. Il valore di questo parametro deve essere "Kerberos", "Negotiate" o "NTLM".
[in] pszDomainName
Dominio dell'account per cui modificare la password.
[in] pszAccountName
Nome utente dell'account per cui modificare la password.
[in] pszOldPassword
Password precedente da modificare.
[in] pszNewPassword
Nuova password per l'account specificato.
[in] bImpersonating
TRUE se il processo di chiamata è in esecuzione come client; in caso contrario, FALSE.
[in] dwReserved
Riservato. Deve essere impostato su zero.
[in, out] pOutput
In input, un puntatore a una struttura SecBufferDesc . La struttura SecBufferDesc deve contenere un singolo buffer di tipo SECBUFFER_CHANGE_PASS_RESPONSE. In output, il membro pvBuffer di tale struttura punta a una struttura DOMAIN_PASSWORD_INFORMATION .
Valore restituito
Se la funzione ha esito positivo, la funzione restituisce SEC_E_OK.
Se la funzione non viene completata, restituisce un codice di errore.
Commenti
Nota
L'intestazione sspi.h definisce ChangeAccountPassword 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 Vista [solo app desktop] |
Server minimo supportato | Windows Server 2008 [solo app desktop] |
Piattaforma di destinazione | Windows |
Intestazione | sspi.h |
Libreria | Secur32.lib |
DLL | Secur32.dll |