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

  • Artigo

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

O método createFileRequest cria uma solicitação de certificado PKCS #10, uma solicitação PKCS nº 7 ou uma solicitação completa de Gerenciamento de Certificados por CMS (CMC) e a armazena em um arquivo. Esse método foi definido pela primeira vez na interface ICEnroll4 .

Sintaxe

HRESULT createFileRequest(
  [in] LONG Flags,
  [in] BSTR strDNName,
  [in] BSTR strUsage,
  [in] BSTR strRequestFileName
);

Parâmetros

[in] Flags

Um valor que especifica o tipo de certificado a ser criado. Esse pode ser um dos valores a seguir.

Valor Significado
XECR_CMC
 CMC completo
XECR_PKCS10_V1_5
 PKCS 10
XECR_PKCS10_V2_0
 PKCS 10 versão 2
XECR_PKCS7
 PKCS 7

[in] strDNName

Esse parâmetro pode ser NULL; caso contrário, esse parâmetro especifica o DN (nome diferenciado) da entidade para a qual a solicitação está sendo feita. O nome DN deve seguir a convenção de nomenclatura X.500 , por exemplo, "CN=User, O=Microsoft". Se um prefixo de duas letras não existir, um OID poderá ser fornecido.

[in] strUsage

Um OID ( identificador de objeto ) que descreve a finalidade da solicitação que está sendo gerada, por exemplo, o certificado Authenticode individual ou comercial ou a autenticação do cliente. Você também pode especificar vários OIDs separados por uma vírgula.

[in] strRequestFileName

O nome do arquivo que receberá a solicitação.

Retornar valor

VB

Se o método for bem-sucedido, o método retornará S_OK.

Se o método falhar, ele retornará um valor HRESULT que indica o erro. Para obter uma lista de códigos de erro comuns, consulte Valores HRESULT comuns.

Comentários

Quando esse método é chamado do script, o método exibe uma interface do usuário que pergunta se o usuário permitirá a criação de uma solicitação de certificado e se o usuário permitirá uma operação de gravação no sistema de arquivos.

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