Share via


SslCrackCertificate, fonction (schannel.h)

[La fonction SslCrackCertificate peut être utilisée dans les systèmes d’exploitation spécifiés dans la section Configuration requise. Il sera peut-être modifié ou indisponible dans les versions ultérieures. Utilisez plutôt la fonction CertCreateCertificateContext .]

Retourne une structure X509Certificate avec les informations contenues dans l’objet BLOB de certificat spécifié.

Cette fonction n’a pas de bibliothèque d’importation associée. Vous devez utiliser les fonctions LoadLibrary et GetProcAddress pour établir une liaison dynamique vers Schannel.dll.

Syntaxe

BOOL SslCrackCertificate(
  [in]  PUCHAR           pbCertificate,
  [in]  DWORD            cbCertificate,
  [in]  DWORD            dwFlags,
  [out] PX509Certificate *ppCertificate
);

Paramètres

[in] pbCertificate

OBJET BLOB de certificat à partir duquel créer la nouvelle structure X509Certificate .

[in] cbCertificate

Longueur, en octets, de l’objet BLOB contenu dans le paramètre pbCertificate .

[in] dwFlags

Définissez cette valeur sur CF_CERT_FROM_FILE pour spécifier que l’objet BLOB de certificat contenu dans le paramètre pbCertificate provient d’un fichier.

[out] ppCertificate

Au retour, reçoit l’adresse d’un pointeur vers la structure X509Certificate créée par cette fonction.

Lorsque vous avez terminé d’utiliser la structure X509Certificate , libérez-la en appelant SslFreeCertificate.

Valeur retournée

Retourne une valeur différente de zéro si cette fonction a correctement créé une structure X509Certificate ou zéro dans le cas contraire.

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 schannel.h
DLL Schannel.dll