Fonction CryptSetOIDFunctionValue (wincrypt.h)

  • Article

La fonction CryptSetOIDFunctionValue définit une valeur pour le type d’encodage, le nom de la fonction, l’OID et le nom de la valeur spécifiés.

Syntaxe

BOOL CryptSetOIDFunctionValue(
  [in] DWORD      dwEncodingType,
  [in] LPCSTR     pszFuncName,
  [in] LPCSTR     pszOID,
  [in] LPCWSTR    pwszValueName,
  [in] DWORD      dwValueType,
  [in] const BYTE *pbValueData,
  [in] DWORD      cbValueData
);

Paramètres

[in] dwEncodingType

Spécifie le type d’encodage à mettre en correspondance. Actuellement, seuls les X509_ASN_ENCODING et les PKCS_7_ASN_ENCODING sont utilisés ; toutefois, des types d’encodage supplémentaires peuvent être ajoutés à l’avenir. Pour faire correspondre les deux types d’encodage actuels, utilisez :

X509_ASN_ENCODING | PKCS_7_ASN_ENCODING.

[in] pszFuncName

Nom de la fonction pour laquelle le type d’encodage, OID et le nom de la valeur sont mis à jour.

[in] pszOID

Si le mot d’ordre élevé de l’identificateur d’objet (OID) est différent de zéro, pszOID est un pointeur vers une chaîne OID telle que « 2.5.29.1 » ou une chaîne ASCII telle que « file ». Si le mot d’ordre élevé de l’OID est égal à zéro, le mot d’ordre inférieur spécifie l’identificateur entier à utiliser comme identificateur d’objet.

[in] pwszValueName

Pointeur vers une chaîne Unicode contenant le nom de la valeur à définir. Si une valeur portant ce nom n’est pas déjà présente, la fonction la crée.

[in] dwValueType

Spécifie le type d’informations à stocker en tant que données de la valeur. Ce paramètre peut prendre les valeurs suivantes.

Valeur Signification
REG_DWORD
 Nombre 32 bits.
REG_EXPAND_SZ
 Chaîne Unicode terminée par null qui contient des références non expirées à des variables d’environnement (par exemple, « %PATH% »).
REG_MULTI_SZ
 Tableau de chaînes Unicode terminées par null, terminées par deux caractères NULL .
REG_SZ
 Chaîne Unicode terminée par null.

[in] pbValueData

Pointe vers une mémoire tampon contenant les données à stocker pour le nom de valeur spécifié.

[in] cbValueData

Spécifie la taille, en octets, des informations pointées par le paramètre pbValueData . Si les données sont de type REG_SZ, REG_EXPAND_SZ ou REG_MULTI_SZ, la taille doit inclure le caractère null de fin.

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).

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

Fonctions de prise en charge OID