Fonction SetCredentialsAttributesA (sspi.h)
Définit les attributs d’une information 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 |
---|---|
|
Définit le nom d’une informations d’identification dans un paramètre pBuffer de type SecPkgCredentials_Names.
Cet attribut n’est pas pris en charge par Schannel en mode WOW64. |
|
Définit le paramètre proxy Kerberos dans un paramètre pBuffer de type SecPkgCredentials_KdcProxySettings.
Cet attribut est uniquement pris en charge par Kerberos. |
|
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. |
|
Définit les forces de chiffrement dans un paramètre pBuffer de type SecPkgCred_CipherStrengths.
Cet attribut est pris en charge uniquement par Schannel. |
|
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 retournée
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.
Code de retour | Description |
---|---|
|
Le handle passé à la fonction n’est pas valide. |
|
L’attribut spécifié n’est pas pris en charge par Schannel. Cette valeur de retour n’est retournée que lorsque le fournisseur SSP Schannel est utilisé. |
|
La mémoire disponible est insuffisante pour effectuer la demande. |
Remarques
Notes
L’en-tête sspi.h définit SetCredentialsAttributes comme un 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.
Configuration requise
Condition requise | Valeur |
---|---|
Client minimal pris en charge | Windows XP [applications de bureau uniquement] |
Serveur minimal pris en charge | Windows Server 2003 [applications de bureau uniquement] |
Plateforme cible | Windows |
En-tête | sspi.h (include Security.h) |
Bibliothèque | Secur32.lib |
DLL | Secur32.dll |