Funzione ChangeAccountPasswordA (sspi.h)

  • Articolo

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