ICertAdmin2 ::SetCAProperty, méthode (certadm.h)

Article
07/16/2024

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

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 Certificate Services, et CANAME est le nom commun de l’autorité de certification, tel qu’entré lors de la configuration des services de certificats. Pour plus d’informations sur le nom de la chaîne de configuration, consultez ICertConfig .

SetCAProperty 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 de l’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é, l’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 être l’une des valeurs suivantes.

Valeur	Signification
PROPTYPE_LONG	Données de signées.
PROPTYPE_DATE	Date/heure (réservée pour une utilisation ultérieure).
PROPTYPE_BINARY	Données binaires.
PROPTYPE_STRING	données de chaîne de chaîneUnicode.

[in] pvarPropertyValue

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

Valeur de retour

VB

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

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

Exigences

Exigence	Valeur
client minimum pris en charge	Aucun pris en charge
serveur minimum pris en charge	Windows Server 2003 [applications de bureau uniquement]
plateforme cible	Windows
d’en-tête	certadm.h (include Certsrv.h)
bibliothèque	Certidl.lib
DLL	Certadm.dll

Voir aussi

ICertAdmin2

ICertAdmin2 ::GetCAProperty

Partager via