Método IX509CertificateRequest::p ut_ParentWindow (certenroll.h)

Artigo
08/22/2023

A propriedade ParentWindow especifica e recupera a ID da janela usada por caixas de diálogo de interface do usuário relacionadas à chave.

Essa propriedade é leitura/gravação.

Sintaxe

HRESULT put_ParentWindow(
  LONG Value
);

Parâmetros

Value

Valor retornado

Nenhum

Comentários

Esse valor de propriedade é usado por caixas de diálogo modais de Controle de Registro de Certificado relacionadas à chave que:

Direcionar um usuário para inserir um cartão inteligente
Solicitar um número de pino de cartão inteligente
Solicitar o nível de proteção para uma nova chave
Solicitar uma senha de usuário antes de acessar uma chave

Se o aplicativo usar caixas de diálogo modais relacionadas à chave, recomendamos que você use essa propriedade para garantir que sua janela seja exibida na frente de outras janelas e que a ação solicitada seja executada antes que o thread possa ser desbloqueado.

Você pode definir essa propriedade antes de chamar qualquer método de inicialização ou o método Encode . Se a solicitação de certificado contiver solicitações aninhadas e você definir a propriedade ParentWindow na solicitação de nível superior, ela será propagada automaticamente para todas as solicitações internas. No entanto, você pode definir a propriedade manualmente em cada um dos objetos internos.

Para uma solicitação PKCS nº 10, o valor da propriedade será recuperado e especificado no objeto IX509PrivateKey associado se a chave existir. Para uma solicitação PKCS nº 7 ou CMC, a ID da janela é atualizada na solicitação interna e em todos os certificados de assinatura.

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