IX509CertificateRequest::get_ParentWindow, méthode (certenroll.h)

Article
08/22/2023

La propriété ParentWindow spécifie et récupère l’ID de la fenêtre utilisée par les boîtes de dialogue d’interface utilisateur liées aux clés.

Cette propriété est en lecture/écriture.

Syntaxe

HRESULT get_ParentWindow(
  LONG *pValue
);

Paramètres

pValue

Valeur de retour

None

Remarques

Cette valeur de propriété est utilisée par les boîtes de dialogue modales du contrôle d’inscription de certificat liées à la clé qui :

Demander à un utilisateur d’insérer un carte intelligent
Demander un numéro d’épingle de carte intelligent
Demander le niveau de protection pour une nouvelle clé
Demander un mot de passe utilisateur avant d’accéder à une clé

Si votre application utilise des boîtes de dialogue modales liées aux clés, nous vous recommandons d’utiliser cette propriété pour vous assurer que votre fenêtre s’affiche devant d’autres fenêtres et que l’action demandée est effectuée avant que le thread puisse être débloqué.

Vous pouvez définir cette propriété avant d’appeler une méthode d’initialisation ou la méthode Encode . Si la demande de certificat contient des requêtes imbriquées et que vous définissez la propriété ParentWindow sur la requête de niveau supérieur, elle est automatiquement propagée à toutes les requêtes internes. Toutefois, vous pouvez définir manuellement la propriété sur chacun des objets internes.

Pour une requête PKCS #10, la valeur de la propriété est récupérée à partir de et spécifiée sur l’objet IX509PrivateKey associé si la clé existe. Pour une demande PKCS #7 ou CMC, l’ID de fenêtre est mis à jour sur la demande interne et sur tous les certificats de signature.

Configuration requise


Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	certenroll.h
DLL	CertEnroll.dll