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

Artigo
03/04/2024

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

O método createRequestWStr 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 BLOB. Esse método foi definido pela primeira vez na interface IEnroll4 .

Sintaxe

HRESULT createRequestWStr(
  [in]  LONG             Flags,
  [in]  LPCWSTR          pwszDNName,
  [in]  LPCWSTR          pwszUsage,
  [out] PCRYPT_DATA_BLOB pblobRequest
);

Parâmetros

[in] Flags

Valor que especifica o tipo de solicitação de certificado a ser criado. 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 Unicode terminada em nulo que contém 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 Unicode terminada em nulo que contém 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.

[out] pblobRequest

Um ponteiro para uma estrutura CRYPT_DATA_BLOB que recebe a solicitação.

Quando terminar de usar essa memória, libere-a passando o membro pbData dessa estrutura para a função CoTaskMemFree .

Retornar valor

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

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

Confira também

IEnroll4

Compartilhar via