Compartilhar via


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:

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

IX509CertificateRequestPkcs10