Método ICEnroll4::addCertTypeToRequestEx (xenroll.h)

Artigo
03/13/2024

[Esse método não está mais disponível para uso a partir do Windows Server 2008 e do Windows Vista.]

O método addCertTypeToRequestEx , como o método addCertTypeToRequest , adiciona um modelo de certificado (ou "tipo de certificado") a uma solicitação. Esse método foi definido pela primeira vez na interface ICEnroll4 .

Esse método está associado ao módulo de política corporativa dos Serviços de Certificados. Esse método é especializado e seu uso não é recomendado para a maioria dos aplicativos. Esta versão pode adicionar uma extensão de modelo V@ a uma solicitação.

Sintaxe

HRESULT addCertTypeToRequestEx(
  [in] LONG lType,
  [in] BSTR bstrOIDOrName,
  [in] LONG lMajorVersion,
  [in] BOOL fMinorVersion,
  [in] LONG lMinorVersion
);

Parâmetros

[in] lType

Indica o tipo de versão da extensão de modelo. Esse pode ser um dos seguintes valores:

Valor	Significado
XECT_EXTENSION_V1	Usa uma extensão de versão 1
XECT_EXTENSION_V2	Usa uma extensão de versão 2

[in] bstrOIDOrName

O nome totalmente qualificado do modelo de certificado que está sendo adicionado à solicitação de certificado. Esse valor é interpretado pela autoridade de certificação.

[in] lMajorVersion

Define a versão principal do modelo. Esse parâmetro será ignorado se lFlag for XECT_EXTENSION_V!.

[in] fMinorVersion

Indica se uma versão secundária do modelo é usada. Esse parâmetro será ignorado se lFlag for XECT_EXTENSION_V!.

[in] lMinorVersion

Define a versão secundária do modelo. Esse parâmetro será ignorado se lFlag for XECT_EXTENSION_V1 ou se fMinorVersion for FALSE.

Retornar valor

VB

O valor retornado é um HRESULT, com S_OK retornado se a chamada for bem-sucedida.

Comentários

Esse método dá suporte apenas ao novo método de solicitação, createRequest. Ele não dá suporte ao método createPKCS10 .

Esse método pode ser chamado várias vezes para estabelecer vários modelos de certificado para a solicitação.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	xenroll.h
Biblioteca	Uuid.lib
DLL	Xenroll.dll