Método IX509CertificateRequestPkcs10::get_KeyContainerNamePrefix (certenroll.h)
A propriedade KeyContainerNamePrefix especifica ou recupera um prefixo usado para criar o nome do contêiner para uma nova chave privada.
Essa propriedade é leitura/gravação.
Sintaxe
HRESULT get_KeyContainerNamePrefix(
BSTR *pValue
);
Parâmetros
pValue
Valor retornado
Nenhum
Comentários
Cada provedor de serviços criptográficos cryptoAPI ou API de criptografia: o provedor de chaves CNG (Próxima Geração) mantém um contêiner de chave para a chave privada. Para recuperar o nome de um contêiner de chave para uma chave existente, use a propriedade ContainerName do objeto IX509PrivateKey .
Um prefixo pode conter qualquer cadeia de caracteres limitada ao comprimento máximo do nome do contêiner de chave e aos caracteres de nome do contêiner legal. Por exemplo, se você não chamar a propriedade ContainerName para especificar um nome de contêiner de chave, uma será criada automaticamente quando a chave privada for criada e o prefixo para o nome do contêiner será a cadeia de caracteres "lp". Para outro exemplo, se você estiver criando um cinto de teste e quiser diferenciar contêineres de chave pelos programas que os geraram, poderá usar o nome do executável como o prefixo.
Você deve definir essa propriedade antes de chamar o método Encode e inicializar o objeto IX509CertificateRequestPkcs10 antes de chamar essa propriedade. Para obter mais informações, consulte qualquer um dos seguintes métodos:
- InitializeDecode
- InitializeFromCertificate
- InitializeFromPrivateKey
- InitializeFromPublicKey
- InitializeFromTemplateName
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 |