Función SetCredentialsAttributesW (sspi.h)

Artículo
03/08/2023

Establece los atributos de una credencial, como el nombre asociado a la credencial. La información es válida para cualquier contexto de seguridad creado con la credencial especificada.

Sintaxis

KSECDDDECLSPEC SECURITY_STATUS SEC_ENTRY SetCredentialsAttributesW(
  [in] PCredHandle   phCredential,
  [in] unsigned long ulAttribute,
  [in] void          *pBuffer,
       unsigned long cbBuffer
);

Parámetros

[in] phCredential

Identificador de las credenciales que se van a establecer.

[in] ulAttribute

Especifica el atributo que se va a establecer. Este parámetro puede ser cualquiera de los siguientes atributos.

Valor	Significado
SECPKG_CRED_ATTR_NAMES	Establece el nombre de una credencial en un parámetro pBuffer de tipo SecPkgCredentials_Names. Este atributo no es compatible con Schannel en modo WOW64.
SECPKG_CRED_ATTR_KDC_PROXY_SETTINGS	Establece la configuración del proxy Kerberos en un parámetro pBuffer de tipo SecPkgCredentials_KdcProxySettings. Este atributo solo es compatible con Kerberos.
SECPKG_ATTR_SUPPORTED_ALGS	Establece los algoritmos admitidos en un parámetro pBuffer de tipo SecPkgCred_SupportedAlgs. Todos los algoritmos admitidos se incluyen, independientemente de si son compatibles con el certificado proporcionado o habilitado en el equipo local. Schannel solo admite este atributo.
SECPKG_ATTR_CIPHER_STRENGTHS	Establece los puntos fuertes del cifrado en un parámetro pBuffer de tipo SecPkgCred_CipherStrengths. Schannel solo admite este atributo.
SECPKG_ATTR_SUPPORTED_PROTOCOLS	Establece los algoritmos admitidos en un parámetro pBuffer de tipo SecPkgCred_SupportedProtocols. Todos los protocolos admitidos se incluyen, independientemente de si son compatibles con el certificado proporcionado o habilitado en el equipo local. Schannel solo admite este atributo.

[in] pBuffer

Puntero a un búfer que contiene el nuevo valor de atributo. El tipo de estructura devuelto depende del valor de ulAttribute.

cbBuffer

Tamaño, en bytes, del búfer de pBuffer .

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto se SEC_E_OK.

Si se produce un error en la función, el valor devuelto puede ser uno de los siguientes códigos de error.

Código devuelto	Descripción
SEC_E_INVALID_HANDLE	El identificador pasado a la función no es válido.
SEC_E_UNSUPPORTED_FUNCTION	Schannel no admite el atributo especificado. Este valor devuelto solo se devolverá cuando se use el SSP de Schannel.
SEC_E_INSUFFICIENT_MEMORY	No hay suficiente memoria disponible para completar la solicitud.

Comentarios

Nota

El encabezado sspi.h define SetCredentialsAttributes 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 XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	sspi.h (include Security.h)
Library	Secur32.lib
Archivo DLL	Secur32.dll