Fonction CryptSetKeyIdentifierProperty (wincrypt.h)

Article
08/27/2023

Important Cette API est déconseillée. Les logiciels nouveaux et existants doivent commencer à utiliser les API de nouvelle génération de chiffrement. Microsoft peut supprimer cette API dans les versions ultérieures.

La fonction CryptSetKeyIdentifierProperty définit la propriété d’un identificateur de clé spécifié. Cette fonction peut définir la propriété sur l’ordinateur identifié dans pwszComputerName.

Syntaxe

BOOL CryptSetKeyIdentifierProperty(
  [in]  const CRYPT_HASH_BLOB *pKeyIdentifier,
  [in]  DWORD                 dwPropId,
  [in]  DWORD                 dwFlags,
  [in]  LPCWSTR               pwszComputerName,
  [in]  void                  *pvReserved,
  [out] const void            *pvData
);

Paramètres

[in] pKeyIdentifier

Pointeur vers un CRYPT_HASH_BLOB contenant l’identificateur de clé.

[in] dwPropId

Identifie la propriété à définir. La valeur de dwPropId détermine le type et le contenu du paramètre pvData . N’importe quel ID de propriété de certificat peut être utilisé. CERT_KEY_PROV_INFO_PROP_ID est la propriété la plus intéressante.

[in] dwFlags

Les indicateurs suivants peuvent être définis. Ils peuvent être combinés avec une opération or au niveau du bit.

Valeur	Signification
CRYPT_KEYID_MACHINE_FLAG	Définit la propriété localMachine (si pwszComputerName a la valeur NULL) ou de l’ordinateur distant (si pwszComputerName n’a pas la valeur NULL). Pour plus d’informations, consultez pwszComputerName.
CRYPT_KEYID_DELETE_FLAG	L’identificateur de clé et toutes ses propriétés sont supprimés.
CRYPT_KEYID_SET_NEW_FLAG	Définit une nouvelle propriété d’identificateur de clé. Si la propriété existe déjà, la tentative échoue et FALSE est retourné avec le dernier code d’erreur défini sur CRYPT_E_EXISTS.

[in] pwszComputerName

Pointeur vers une chaîne terminée par null qui contient le nom d’un ordinateur distant qui a l’identificateur de clé où les propriétés sont définies. Si CRYPT_KEYID_MACHINE_FLAG indicateur est défini, recherche une liste d’identificateurs de clé sur l’ordinateur distant. Si l’ordinateur local doit être défini et non un ordinateur distant, définissez pwszComputerName sur NULL.

[in] pvReserved

Réservé pour une utilisation ultérieure et doit avoir la valeur NULL.

[out] pvData

Si dwPropId est CERT_KEY_PROV_INFO_PROP_ID, pvData pointe vers une structure de CRYPT_KEY_PROV_INFO contenant la propriété de l’identificateur de clé.

Si dwPropId n’est pas CERT_KEY_PROV_INFO_PROP_ID, pvData pointe vers une structure CRYPT_DATA_BLOB contenant la propriété de l’identificateur de clé.

La définition de pvData sur NULL supprime la propriété.

Valeur retournée

Si la fonction réussit, la valeur de retour est différente de zéro (TRUE).

Si la fonction échoue, la valeur de retour est zéro (FALSE). Pour obtenir des informations d’erreur étendues, appelez GetLastError.

Note Si CRYPT_KEYID_SET_NEW_FLAG est défini et que la propriété existe déjà, FALSE est retourné avec le dernier code d’erreur défini sur CRYPT_E_EXISTS.

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	wincrypt.h
Bibliothèque	Crypt32.lib
DLL	Crypt32.dll

Voir aussi

CryptEnumKeyIdentifierProperties

CryptGetKeyIdentifierProperty

Fonctions d’identificateur de clé

Partager via