Método IEnroll4::createFileRequestWStr (xenroll.h)

Artigo
08/28/2023

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

O método createFileRequestWStr cria uma solicitação de certificado de formato PKCS nº 10, PKCS nº 7 ou gerenciamento completo de certificados por CMS (CMC) e o armazena em um arquivo. Esse método foi definido pela primeira vez na interface IEnroll4 .

Sintaxe

HRESULT createFileRequestWStr(
  [in] LONG    Flags,
  [in] LPCWSTR pwszDNName,
  [in] LPCWSTR pwszUsage,
  [in] LPCWSTR pwszRequestFileName
);

Parâmetros

[in] Flags

Valor que especifica o tipo de solicitação de certificado a ser criada. Especifique um dos valores a seguir.

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

[in] pwszDNName

Um ponteiro para uma cadeia de caracteres largos terminada em nulo que representa o nome diferenciado (DN) 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 (identificador de objeto) poderá ser fornecido. Esse parâmetro pode ser NULL.

[in] pwszUsage

Um ponteiro para uma cadeia de caracteres largos terminada em nulo para o OID que descreve a finalidade do certificado que está sendo gerado, por exemplo, certificado Authenticode individual ou comercial ou autenticação de cliente. Você também pode especificar vários OIDs separados por uma vírgula.

[in] pwszRequestFileName

Um ponteiro para uma cadeia de caracteres largos terminada em nulo que contém o nome do arquivo que receberá a solicitação.

Valor retornado

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.

Requisitos


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

Confira também

IEnroll4

Compartilhar via