Función ChangeAccountPasswordA (sspi.h)

La función ChangeAccountPassword cambia la contraseña de una cuenta de dominio de Windows mediante el proveedor de soporte técnico de seguridad especificado.

Esta función solo es compatible con los proveedores De Microsoft Kerberos, Microsoft Negotiate y Microsoft NTLM .

Sintaxis

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
);

Parámetros

[in] pszPackageName

Nombre del proveedor que se va a usar. El valor de este parámetro debe ser "Kerberos", "Negotiate" o "NTLM".

[in] pszDomainName

Dominio de la cuenta para la que se va a cambiar la contraseña.

[in] pszAccountName

Nombre de usuario de la cuenta para la que se va a cambiar la contraseña.

[in] pszOldPassword

Contraseña antigua que se va a cambiar.

[in] pszNewPassword

Nueva contraseña de la cuenta especificada.

[in] bImpersonating

TRUE si el proceso de llamada se ejecuta como cliente; de lo contrario, FALSE.

[in] dwReserved

Reservado. Debe establecerse en cero.

[in, out] pOutput

En la entrada, un puntero a una estructura SecBufferDesc . La estructura SecBufferDesc debe contener un único búfer de tipo SECBUFFER_CHANGE_PASS_RESPONSE. En la salida, el miembro pvBuffer de esa estructura apunta a una estructura de DOMAIN_PASSWORD_INFORMATION .

Valor devuelto

Si la función se ejecuta correctamente, la función devuelve SEC_E_OK.

Si la función presenta un error, devuelve un código de error.

Comentarios

Nota

El encabezado sspi.h define ChangeAccountPassword como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	sspi.h
Library	Secur32.lib
Archivo DLL	Secur32.dll