Funzione ChangeAccountPasswordA (sspi.h)

Articolo
11/20/2024

La funzione ChangeAccountPassword modifica la password per un account di dominio di Windows usando il provider di supporto della sicurezza specificato.

Questa funzione è supportata solo dai provider di Microsoft Kerberos, Microsoft Negotiatee provider di 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 utilizzare. 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 chiamante è in esecuzione come client; in caso contrario, FALSE.

[in] dwReserved

Riservato. Deve essere impostato su zero.

[in, out] pOutput

All'input, un puntatore a una struttura SecBufferDesc. La struttura di 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 ha esito negativo, restituisce un codice di errore.

Osservazioni

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 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 Vista [solo app desktop]
server minimo supportato	Windows Server 2008 [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	sspi.h
libreria	Secur32.lib
dll	Secur32.dll

Condividi tramite