Función ChangeAccountPasswordW (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 Microsoft Kerberos, Microsoft Negotiate y Microsoft NTLM .

Sintaxis

SECURITY_STATUS SEC_ENTRY ChangeAccountPasswordW(
  [in]      SEC_WCHAR      *pszPackageName,
  [in]      SEC_WCHAR      *pszDomainName,
  [in]      SEC_WCHAR      *pszAccountName,
  [in]      SEC_WCHAR      *pszOldPassword,
  [in]      SEC_WCHAR      *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 DOMAIN_PASSWORD_INFORMATION .

Valor devuelto

Si la función se realiza 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 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 Convenciones para prototipos de función.

Requisitos

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