SetCredentialsAttributesA, fonction (sspi.h)

Article
11/20/2024

Définit les attributs d’une d’informations d’identification, comme le nom associé aux informations d’identification. Les informations sont valides pour tout contexte de sécurité créé avec les informations d’identification spécifiées.

Syntaxe

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

Paramètres

[in] phCredential

Handle des informations d’identification à définir.

[in] ulAttribute

Spécifie l’attribut à définir. Ce paramètre peut être l’un des attributs suivants.

Valeur	Signification
SECPKG_CRED_ATTR_NAMES	Définit le nom d’une information d’identification dans un paramètre pBuffer de type SecPkgCredentials_Names. Cet attribut n’est pas pris en charge par Schannel en mode WOW64.
SECPKG_CRED_ATTR_KDC_PROXY_SETTINGS	Définit le paramètre de proxy Kerberos dans un paramètre pBuffer de type SecPkgCredentials_KdcProxySettings. Cet attribut est pris en charge uniquement par Kerberos.
SECPKG_ATTR_SUPPORTED_ALGS	Définit les algorithmes pris en charge dans un paramètre pBuffer de type SecPkgCred_SupportedAlgs. Tous les algorithmes pris en charge sont inclus, qu’ils soient pris en charge par le certificat fourni ou activés sur l’ordinateur local. Cet attribut est pris en charge uniquement par Schannel.
SECPKG_ATTR_CIPHER_STRENGTHS	Définit les forces de chiffrement dans un paramètre pBuffer de type SecPkgCred_CipherStrengths. Cet attribut est pris en charge uniquement par Schannel.
SECPKG_ATTR_SUPPORTED_PROTOCOLS	Définit les algorithmes pris en charge dans un paramètre pBuffer de type SecPkgCred_SupportedProtocols. Tous les protocoles pris en charge sont inclus, qu’ils soient pris en charge par le certificat fourni ou activés sur l’ordinateur local. Cet attribut est pris en charge uniquement par Schannel.

[in] pBuffer

Pointeur vers une mémoire tampon qui contient la nouvelle valeur d’attribut. Le type de structure retourné dépend de la valeur de ulAttribute.

cbBuffer

Taille, en octets, de la mémoire tampon pBuffer .

Valeur de retour

Si la fonction réussit, la valeur de retour est SEC_E_OK.

Si la fonction échoue, la valeur de retour peut être l’un des codes d’erreur suivants.

Retourner le code	Description
SEC_E_INVALID_HANDLE	Le handle passé à la fonction n’est pas valide.
SEC_E_UNSUPPORTED_FUNCTION	L’attribut spécifié n’est pas pris en charge par Schannel. Cette valeur de retour ne sera retournée que lorsque le SSP Schannel est utilisé.
SEC_E_INSUFFICIENT_MEMORY	La mémoire insuffisante est disponible pour terminer la requête.

Remarques

Note

L’en-tête sspi.h définit SetCredentialsAttributes en tant qu’alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows XP [applications de bureau uniquement]
serveur minimum pris en charge	Windows Server 2003 [applications de bureau uniquement]
plateforme cible	Windows
d’en-tête	sspi.h (include Security.h)
bibliothèque	Secur32.lib
DLL	Secur32.dll