IX509CertificateRequest::get_ParentWindow method (certenroll.h)

The ParentWindow property specifies and retrieves the ID of the window used by key-related user interface dialogs.

This property is read/write.

Syntax

HRESULT get_ParentWindow(
  LONG *pValue
);

Parameters

pValue

Return value

None

Remarks

This property value is used by key-related Certificate Enrollment Control modal dialogs that:

  • Direct a user to insert a smart card
  • Request a smart card pin number
  • Request the protection level for a new key
  • Request a user password before accessing a key

If your application uses key-related modal dialogs, we recommend that you use this property to ensure that your window displays in front of other windows and that the requested action is performed before the thread can be unblocked.

You can set this property before calling any initialization method or the Encode method. If the certificate request contains nested requests and you set the ParentWindow property on the top level request, it is automatically propagated to all of the inner requests. You can, however, set the property manually on each of the inner objects.

For a PKCS #10 request, the property value is retrieved from and specified on the associated IX509PrivateKey object if the key exists. For a PKCS #7 or CMC request the window ID is updated on the inner request and all signing certificates.

Requirements

   
Minimum supported client Windows Vista [desktop apps only]
Minimum supported server Windows Server 2008 [desktop apps only]
Target Platform Windows
Header certenroll.h
DLL CertEnroll.dll

See also

IX509CertificateRequest

IX509CertificateRequestCertificate

IX509CertificateRequestCmc

IX509CertificateRequestPkcs10

IX509CertificateRequestPkcs7

IX509SignatureInformation