Partager via

CASetupProperty, énumération (casetup.h)

  • Article

L’énumération CASetupProperty spécifie un type de propriété pour l’installation et la configuration d’un rôle d’autorité de certification lors de l’utilisation de l’interface ICertSrvSetup.

Syntax

typedef enum __MIDL___MIDL_itf_casetup_0000_0002_0001 {
  ENUM_SETUPPROP_INVALID = -1,
  ENUM_SETUPPROP_CATYPE = 0,
  ENUM_SETUPPROP_CAKEYINFORMATION = 1,
  ENUM_SETUPPROP_INTERACTIVE = 2,
  ENUM_SETUPPROP_CANAME = 3,
  ENUM_SETUPPROP_CADSSUFFIX = 4,
  ENUM_SETUPPROP_VALIDITYPERIOD = 5,
  ENUM_SETUPPROP_VALIDITYPERIODUNIT = 6,
  ENUM_SETUPPROP_EXPIRATIONDATE = 7,
  ENUM_SETUPPROP_PRESERVEDATABASE = 8,
  ENUM_SETUPPROP_DATABASEDIRECTORY = 9,
  ENUM_SETUPPROP_LOGDIRECTORY = 10,
  ENUM_SETUPPROP_SHAREDFOLDER = 11,
  ENUM_SETUPPROP_PARENTCAMACHINE = 12,
  ENUM_SETUPPROP_PARENTCANAME = 13,
  ENUM_SETUPPROP_REQUESTFILE = 14,
  ENUM_SETUPPROP_WEBCAMACHINE = 15,
  ENUM_SETUPPROP_WEBCANAME = 16
} CASetupProperty;

Constantes

 
ENUM_SETUPPROP_INVALID
Valeur : -1
Valeur qui spécifie un type de propriété non valide.
ENUM_SETUPPROP_CATYPE
Valeur : 0
Valeur VT_I4 qui spécifie une valeur de l’énumération ENUM_CATYPES .

Si l’ordinateur n’est pas joint à un domaine, ou si l’appelant

n’est pas un administrateur d’entreprise ou de domaine, mais un administrateur local, la valeur par défaut est ENUM_STANDALONE_ROOTCA. Si l’ordinateur est joint à un domaine, que l’appelant est un administrateur d’entreprise ou de domaine, et qu’une autorité de certification racine d’entreprise existe déjà, la valeur par défaut est ENUM_ENTERPRISE_SUBCA ou, si aucune autorité de certification racine d’entreprise n’existe, la valeur par défaut est ENUM_ENTERPRISE_ROOTCA.
ENUM_SETUPPROP_CAKEYINFORMATION
Valeur : 1
Une valeur VT_DISPATCH , sous la forme d’un objet CCertSrvSetupKeyInformation , qui spécifie les informations de clé privée utilisées pour un certificat d’autorité de certification. Par défaut, le programme d’installation génère une nouvelle clé

avec une longueur de clé de 2 048 bits pour les autorités de certification racine et subordonnées à l’aide de « Microsoft »

Fournisseur de chiffrement fort. »
ENUM_SETUPPROP_INTERACTIVE
Valeur : 2
Valeur VT_BOOL qui indique si le fournisseur de services de chiffrement (CSP) est autorisé à interagir avec le bureau. La valeur par défaut est false.
ENUM_SETUPPROP_CANAME
Valeur : 3
Valeur VT_BSTR qui contient le nom commun de l’autorité de certification. Par défaut, le commun

name est DomainName-LocalComputerName-CAName.
ENUM_SETUPPROP_CADSSUFFIX
Valeur : 4
Valeur VT_BSTR qui contient le suffixe de nom unique d’un nom d’autorité de certification.
ENUM_SETUPPROP_VALIDITYPERIOD
Valeur : 5
Valeur VT_I4 qui spécifie le nombre d’unités dans la période de validité spécifiée par le type de propriété ENUM_SETUPPROP_VALIDITYPERIODUNIT . Pour une autorité de certification subordonnée, la période de validité est déterminée par l’autorité de certification parente.
ENUM_SETUPPROP_VALIDITYPERIODUNIT
Valeur : 6
Valeur VT_I4 qui spécifie une valeur de l’énumération ENUM_PERIOD qui indique les unités de temps de la période de validité. Pour une autorité de certification subordonnée, l’unité de temps de période de validité est déterminée par l’autorité de certification parente.
ENUM_SETUPPROP_EXPIRATIONDATE
Valeur : 7
Valeur VT_BSTR qui spécifie la date d’expiration attendue du certificat d’autorité de certification racine en fonction de l’heure actuelle, de la période de validité et de l’unité de période de validité. Pour une autorité de certification subordonnée, la date d’expiration est

déterminé par son autorité de certification parente.
ENUM_SETUPPROP_PRESERVEDATABASE
Valeur : 8
Valeur VT_BOOL qui spécifie s’il faut conserver une base de données existante. Cela est pertinent dans les conditions suivantes :


  • Une autorité de certification

    a été installé précédemment (puis désinstallé) sur cet ordinateur.

  • Une clé existante (et son certificat associé) est utilisée pour l’installation.

  • Une base de données existe dans le répertoire de base de données donné.
ENUM_SETUPPROP_DATABASEDIRECTORY
Valeur : 9
Valeur VT_BSTR qui spécifie le chemin d’accès du répertoire dans lequel les fichiers de base de données d’autorité de certification sont stockés après l’installation. Le chemin par défaut est %SystemRoot%\System32\Certlog.
ENUM_SETUPPROP_LOGDIRECTORY
Valeur : 10
Valeur VT_BSTR qui spécifie le chemin d’accès du répertoire où les fichiers journaux de base de données d’autorité de certification sont stockés après l’installation. Le chemin par défaut est %SystemRoot%\System32\Certlog.
ENUM_SETUPPROP_SHAREDFOLDER
Valeur : 11
Cette valeur n’est pas utilisée et est réservée à une utilisation ultérieure.
ENUM_SETUPPROP_PARENTCAMACHINE
Valeur : 12
Valeur VT_BSTR qui spécifie le nom de l’ordinateur qui héberge l’autorité de certification parente. Cette valeur s’applique uniquement si une autorité de certification subordonnée est installée. Il n'y a pas de valeur par défaut.
ENUM_SETUPPROP_PARENTCANAME
Valeur : 13
Valeur VT_BSTR qui spécifie le nom de l’autorité de certification parente. Cette valeur s’applique uniquement si une autorité de certification subordonnée est installée. Il n'y a pas de valeur par défaut.
ENUM_SETUPPROP_REQUESTFILE
Valeur : 14
Valeur VT_BSTR qui spécifie le chemin d’accès au fichier à utiliser pour enregistrer une demande d’autorité de certification subordonnée, afin qu’elle puisse être envoyée ultérieurement à l’autorité de certification parente. La valeur par défaut est %SystemDrive%\\DNSMachineName_CAName.req.
ENUM_SETUPPROP_WEBCAMACHINE
Valeur : 15
Valeur VT_BSTR qui spécifie le nom de l’ordinateur qui héberge l’autorité de certification. Cette valeur s’applique uniquement si la prise en charge du rôle d’inscription web de l’autorité de certification est en cours d’installation. Il n'y a pas de valeur par défaut.
ENUM_SETUPPROP_WEBCANAME
Valeur : 16
Valeur VT_BSTR qui spécifie le nom de l’autorité de certification. Cette valeur s’applique uniquement si la prise en charge du rôle d’inscription web de l’autorité de certification est en cours d’installation. Il n'y a pas de valeur par défaut.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Aucun pris en charge
Serveur minimal pris en charge Windows Server 2008 [applications de bureau uniquement]
En-tête casetup.h