Méthode ICertManageModule ::SetProperty (certmod.h)

Article
08/22/2023

La méthode SetProperty permet à un module de définir une valeur de propriété.

Syntaxe

HRESULT SetProperty(
  [in] const BSTR    strConfig,
  [in] BSTR          strStorageLocation,
  [in] BSTR          strPropertyName,
  [in] LONG          Flags,
  [in] const VARIANT *pvarProperty
);

Paramètres

[in] strConfig

Représente la chaîne de configuration du serveur des services de certificats sous la forme COMPUTERNAME\CANAME, où COMPUTERNAME est le nom réseau du serveur des services de certificat et CANAME est le nom commun de l’autorité de certification (CA) telle qu’entrée pour l’autorité de certification lors de l’installation des services de certificat. Pour plus d’informations sur le nom de la chaîne de configuration, consultez ICertConfig.

[in] strStorageLocation

Emplacement qui fournit le stockage pour les valeurs de propriété, comme décrit dans la définition de strStorageLocation dans ICertManageModule ::GetProperty.

[in] strPropertyName

Nom de la propriété dont la valeur est affectée. Les modules de stratégie et de sortie doivent prendre en charge les propriétés suivantes, qui sont utilisées par Certificate Services Manager.

Valeur	Signification
Nom	Nom du module.
Description	Description du module.
Copyright	Copyright relatif au module.
Version de fichier	Version du fichier de module.
Version du produit	Version du module.

[in] Flags

Ce paramètre est réservé et doit être défini sur zéro.

[in] pvarProperty

Valeur affectée à la propriété spécifiée par strPropertyName.

Valeur retournée

VB

Si la méthode réussit, la méthode retourne S_OK.

Si la méthode échoue, elle retourne une valeur HRESULT qui indique l’erreur. Pour obtenir la liste des codes d’erreur courants, consultez Valeurs HRESULT courantes.

Remarques

Cette méthode est destinée aux fonctionnalités futures. Une implémentation minimale est toutefois requise pour répondre aux exigences de l’interface ICertManageModule .

Exemples

#include <windows.h>
#include <Certmod.h>

HRESULT CCertManagePolicyModule::SetProperty(
            /* [in] */ const BSTR strConfig,
            /* [in] */ BSTR strStorageLocation,
            /* [in] */ BSTR strPropertyName,
            /* [in] */ LONG Flags,
            /* [in] */ const VARIANT *pvarProperty)
{
    // This implementation fulfills the minimal requirement
    // needed for ICertManageModule::SetProperty.
    return S_OK;
}

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	certmod.h (include Certsrv.h)
Bibliothèque	Certidl.lib