Método ICertSrvSetup::SetCADistinguishedName (casetup.h)

O método SetCADistinguishedName define um nome comum de AC (autoridade de certificação ) e um sufixo de nome diferenciado opcional.

Sintaxe

HRESULT SetCADistinguishedName(
  [in] const BSTR   bstrCADN,
  [in] VARIANT_BOOL bIgnoreUnicode,
  [in] VARIANT_BOOL bOverwriteExistingKey,
  [in] VARIANT_BOOL bOverwriteExistingCAInDS
);

Parâmetros

[in] bstrCADN

Uma cadeia de caracteres que contém o nome de uma AC no formato CommonName, DistinguishedNameSuffix, em que a vírgula (,) e DistinguishedNameSuffix são opcionais.

A tabela a seguir descreve um exemplo de um nome diferenciado, incluindo o sufixo de nome diferenciado opcional, para o computador MyServer.

Valor	Significado
CN=mydomain-MyServer-CA	Nome comum para o computador MyServer que pertence ao domínio MyDomain .
DC=MyDomain,DC=MyCompany,DC=com	Sufixo de nome diferenciado (opcional)
CN=MyDomain-MyServer-CA,DC=MyDomain,DC=MyCompany,DC=com	Nome diferenciado, incluindo o sufixo opcional

[in] bIgnoreUnicode

Um valor que indica se a codificação Unicode deve ser permitida das informações de nome. Um valor de VARIANT_TRUE habilita a codificação Unicode.

[in] bOverwriteExistingKey

Um valor que indica se o nome deve ser permitido em bstrCADN, mesmo que exista uma chave privada com o mesmo nome no computador. Um valor de VARIANT_TRUE permite que o método substitua a chave existente.

[in] bOverwriteExistingCAInDS

Um valor que indica se o nome deve ser permitido em bstrCADN, mesmo que exista uma AC com o mesmo nome diferenciado no serviço de diretório. Um valor de VARIANT_TRUE permite que o método substitua a entrada de serviço de diretório existente.

Retornar valor

Nenhum

Comentários

Após o sucesso, o método SetCADistinguishedName altera os valores da propriedade ENUM_SETUPPROP_CANAME e ENUM_SETUPPROP_CADSSUFFIX para refletir o nome bstrCADN . Para obter mais informações sobre as propriedades de instalação, consulte CASetupProperty.

Após a falha, o método SetCADistinguishedName pode definir informações de erro adicionais nas propriedades CAErrorId e CAErrorString .

Se uma chave existente e seu certificado associado estiverem sendo usados para configurar a AC, esse método não deverá ser chamado. Se uma chave existente estiver sendo usada para configurar a AC, sem usar o certificado associado, o nome comum em bstrCADN deverá corresponder ao ContainerNamesanitizado da chave.

Se bstrCADN incluir codificação UTF8, defina o sinalizador apropriado em CAPolicy.inf e coloque-o no %windir%.

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]
Plataforma de Destino	Windows
Cabeçalho	casetup.h
DLL	Certocm.dll

Confira também

ICertSrvSetup