Función SetCredentialsAttributesA (sspi.h)

Artículo
11/20/2024

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

Sintaxis

SECURITY_STATUS SEC_ENTRY SetCredentialsAttributesA(
  [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 atributos siguientes.

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 de pBuffer de tipo SecPkgCredentials_KdcProxySettings. Este atributo solo es compatible con Kerberos.
SECPKG_ATTR_SUPPORTED_ALGS	Establece los algoritmos admitidos en un parámetro de 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. Este atributo solo es compatible con Schannel.
SECPKG_ATTR_CIPHER_STRENGTHS	Establece los puntos fuertes del cifrado en un parámetro de pBuffer de tipo SecPkgCred_CipherStrengths. Este atributo solo es compatible con Schannel.
SECPKG_ATTR_SUPPORTED_PROTOCOLS	Establece los algoritmos admitidos en un parámetro de 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. Este atributo solo es compatible con Schannel.

[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 es 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.

Observaciones

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 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 XP [solo aplicaciones de escritorio]
servidor mínimo admitido	Windows Server 2003 [solo aplicaciones de escritorio]
de la plataforma de destino de	Windows
encabezado de	sspi.h (include Security.h)
biblioteca de	Secur32.lib
DLL de	Secur32.dll