Compartilhar via


Método IX509PrivateKey::Create (certenroll.h)

O método Create cria uma chave privada assimétrica.

Sintaxe

HRESULT Create();

Retornar valor

Se a função for bem-sucedida, a função retornará S_OK.

Se a função falhar, ela retornará um valor HRESULT que indica o erro. Os possíveis valores incluem, mas sem limitação, aqueles na tabela a seguir. Para obter uma lista de códigos de erro comuns, consulte Valores HRESULT comuns.

Valor/código retornado Descrição
HRESULT_FROM_WIN32(ERROR_BUSY)
O identificador CSP não é NULL.
HRESULT_FROM_WIN32(ERROR_FILE_EXISTS)
A chave já existe.

Comentários

Se você não definir as propriedades CspStatus, ProviderName ou ProviderType , esse método usará os valores padrão de provedor, tamanho da chave e KeySpec ao criar a chave. Em uma nova instalação do sistema operacional, por exemplo, o Microsoft Enhanced Cryptographic Provider v1.0 é o provedor padrão.

Se você não definir a propriedade ContainerName , esse método gerará automaticamente um nome. O nome gerado inclui um GUID e, se a propriedade ContainerNamePrefix não estiver definida, um prefixo de "lp-". Se o provedor for um provedor de cartão inteligente, o nome gerado não excederá o valor MaxKeyContainerNameLength especificado pelo provedor. Se o nome gerado inicialmente exceder esse valor, ele será truncado para quarenta caracteres.

Não é possível definir as propriedades a seguir depois de chamar os métodos Criar ou Abrir . Se você quiser especificá-los, deverá fazê-lo antes de chamar um desses métodos.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho certenroll.h
DLL CertEnroll.dll

Confira também

IX509PrivateKey