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 de especificado.

Esta función solo es compatible con los proveedores de Microsoft Kerberos, Microsoft Negotiatey 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 está ejecutando 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 se produce un error en la función, devuelve un código de error.

Observaciones

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 neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows Vista [solo aplicaciones de escritorio]
servidor mínimo admitido	Windows Server 2008 [solo aplicaciones de escritorio]
de la plataforma de destino de	Windows
encabezado de	sspi.h
biblioteca de	Secur32.lib
DLL de	Secur32.dll