Enumeração CASetupProperty (casetup.h)

  • Artigo

A enumeração CASetupProperty especifica um tipo de propriedade para instalação e configuração de uma função de AC (autoridade de certificação ) ao usar a 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
Valor: -1
Um valor que especifica um tipo de propriedade que não é válido.
ENUM_SETUPPROP_CATYPE
Valor: 0
Um valor VT_I4 que especifica um valor da enumeração ENUM_CATYPES .

Se o computador não estiver ingressado em um domínio ou o chamador

não é um administrador corporativo ou de domínio, mas é um administrador local, o valor padrão é ENUM_STANDALONE_ROOTCA. Se o computador estiver ingressado em um domínio, o chamador for um administrador enterprise ou de domínio e uma AC raiz corporativa já existir, o padrão será ENUM_ENTERPRISE_SUBCA ou, se nenhuma AC raiz corporativa existir, o valor padrão será ENUM_ENTERPRISE_ROOTCA.
ENUM_SETUPPROP_CAKEYINFORMATION
Valor: 1
Um valor VT_DISPATCH , na forma de um objeto CCertSrvSetupKeyInformation , que especifica as informações de chave privada usadas para um certificado de autoridade de certificação. Por padrão, a configuração gera uma nova chave

com um comprimento de chave de 2048 bits para CAs raiz e subordinada usando "Microsoft

Provedor criptográfico forte."
ENUM_SETUPPROP_INTERACTIVE
Valor: 2
Um valor VT_BOOL que indica se o provedor de serviços criptográficos (CSP) tem permissão para interagir com a área de trabalho. O padrão é false.
ENUM_SETUPPROP_CANAME
Valor: 3
Um valor VT_BSTR que contém o nome comum para a AC. Por padrão, o comum

name é DomainName-LocalComputerName-CAName.
ENUM_SETUPPROP_CADSSUFFIX
Valor: 4
Um valor VT_BSTR que contém o sufixo de nome diferenciado para um nome de AC.
ENUM_SETUPPROP_VALIDITYPERIOD
Valor: 5
Um valor VT_I4 que especifica o número de unidades no período de validade, conforme especificado pelo tipo de propriedade ENUM_SETUPPROP_VALIDITYPERIODUNIT . Para uma AC subordinada, o período de validade é determinado pela AC pai.
ENUM_SETUPPROP_VALIDITYPERIODUNIT
Valor: 6
Um valor VT_I4 que especifica um valor da enumeração ENUM_PERIOD que indica as unidades de tempo do período de validade. Para uma AC subordinada, a unidade de tempo de período de validade é determinada pela AC pai.
ENUM_SETUPPROP_EXPIRATIONDATE
Valor: 7
Um valor VT_BSTR que especifica a data de validade esperada do certificado de autoridade de certificação raiz com base na hora atual, no período de validade e na unidade do período de validade. Para uma AC subordinada, a data de validade é

determinado por sua AC pai.
ENUM_SETUPPROP_PRESERVEDATABASE
Valor: 8
Um valor VT_BOOL que especifica se um banco de dados existente deve ser preservado. Isso é relevante nas seguintes condições:


  • Uma AC

    foi instalado anteriormente (e posteriormente desinstalado) neste computador.

  • Uma chave existente (e seu certificado associado) está sendo usada para instalação.

  • Existe um banco de dados no diretório de banco de dados fornecido.
ENUM_SETUPPROP_DATABASEDIRECTORY
Valor: 9
Um valor VT_BSTR que especifica o caminho do diretório em que os arquivos de banco de dados da AC são armazenados após a instalação. O caminho padrão é %SystemRoot%\System32\Certlog.
ENUM_SETUPPROP_LOGDIRECTORY
Valor: 10
Um valor VT_BSTR que especifica o caminho do diretório em que os arquivos de log do banco de dados da AC são armazenados após a instalação. O caminho padrão é %SystemRoot%\System32\Certlog.
ENUM_SETUPPROP_SHAREDFOLDER
Valor: 11
Esse valor não é usado e é reservado para uso futuro.
ENUM_SETUPPROP_PARENTCAMACHINE
Valor: 12
Um valor VT_BSTR que especifica o nome do computador que está hospedando a AC pai. Esse valor só será aplicável se uma AC subordinada estiver sendo instalada. Nenhum valor padrão.
ENUM_SETUPPROP_PARENTCANAME
Valor: 13
Um valor VT_BSTR que especifica o nome da AC pai. Esse valor só será aplicável se uma AC subordinada estiver sendo instalada. Nenhum valor padrão.
ENUM_SETUPPROP_REQUESTFILE
Valor: 14
Um valor VT_BSTR que especifica o caminho do arquivo a ser usado para salvar uma solicitação de AC subordinada, para que ela possa ser enviada posteriormente à AC pai. O valor padrão é %SystemDrive%\\DNSMachineName_CAName.req.
ENUM_SETUPPROP_WEBCAMACHINE
Valor: 15
Um valor VT_BSTR que especifica o nome do computador que está hospedando a AC. Esse valor só será aplicável se o suporte para a função de Registro Web da Autoridade de Certificação estiver sendo instalado. Nenhum valor padrão.
ENUM_SETUPPROP_WEBCANAME
Valor: 16
Um valor VT_BSTR que especifica o nome da AC. Esse valor só será aplicável se o suporte para a função de Registro Web da Autoridade de Certificação estiver sendo instalado. Nenhum valor padrão.

Requisitos

Requisito Valor
Cliente mínimo com suporte Nenhum compatível
Servidor mínimo com suporte Windows Server 2008 [somente aplicativos da área de trabalho]
Cabeçalho casetup.h