Méthode ICertAdmin2 ::SetCAProperty (certadm.h)

Article
02/23/2024

La méthode SetCAProperty définit une valeur de propriété pour l’autorité de certification .

Syntaxe

HRESULT SetCAProperty(
  [in] const BSTR strConfig,
  [in] LONG       PropId,
  [in] LONG       PropIndex,
  [in] LONG       PropType,
  [in] VARIANT    *pvarPropertyValue
);

Paramètres

[in] strConfig

Valeur de chaîne qui représente une chaîne de configuration valide pour l’autorité de certification sous la forme COMPUTERNAME\CANAME, où COMPUTERNAME est le nom réseau du serveur des services de certificats et CANAME est le nom commun de l’autorité de certification, tel qu’entré lors de l’installation des services de certificats. Pour plus d’informations sur le nom de la chaîne de configuration, consultez ICertConfig.

ImportantSetCAProperty n’efface pas le cache interne lorsque la chaîne de configuration est modifiée. Lorsque vous modifiez la chaîne de configuration de l’autorité de certification, vous devez instancier un nouvel objet ICertAdmin et appeler à nouveau cette méthode avec la nouvelle chaîne de configuration.

[in] PropId

Spécifie l’un des identificateurs de propriété suivants.

Pour plus d’informations sur toutes les propriétés d’autorité de certification, y compris celles en lecture seule, consultez ICertAdmin2 ::GetCAProperty.

Valeur	Signification
CR_PROP_KRACERT	Certificat KRA (Key Recovery Agent) de l’autorité de certification. Format de données : binaire, indexé.
CR_PROP_KRACERTCOUNT	Nombre de certificats KRA pour l’autorité de certification. Format des données : long.
CR_PROP_KRACERTUSEDCOUNT	Nombre de certificats KRA utilisés par l’autorité de certification. Format des données : long.
CR_PROP_ROLESEPARATIONENABLED	Valeur qui spécifie si la séparation des rôles est activée. Format des données : long.
CR_PROP_TEMPLATES	Liste des modèles pris en charge par l’autorité de certification. Format de données : Chaîne.

[in] PropIndex

Si le paramètre PropId est indexé, index de base zéro à utiliser lors de la récupération de la valeur de propriété. Si PropId n’est pas indexé, cette valeur est ignorée.

[in] PropType

Spécifie le type de la propriété . Ce paramètre peut prendre les valeurs suivantes.

Valeur	Signification
PROPTYPE_LONG	Données long signées.
PROPTYPE_DATE	Date/heure (réservée à une utilisation ultérieure).
PROPTYPE_BINARY	Données binaires.
PROPTYPE_STRING	Données dechaîne Unicode.

[in] pvarPropertyValue

C++	Pointeur vers un VARIANT qui spécifie la valeur de la propriété.
VB	Variant qui spécifie la valeur de la propriété.

Valeur retournée

VB

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

Si la fonction échoue, la valeur de retour est un HRESULT qui indique l’erreur. Pour obtenir la liste des codes d’erreur courants, consultez Valeurs HRESULT courantes.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Aucun pris en charge
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	certadm.h (include Certsrv.h)
Bibliothèque	Certidl.lib
DLL	Certadm.dll

Voir aussi

ICertAdmin2

ICertAdmin2 ::GetCAProperty

Partager via