IX509CertificateRequest::get_ParentWindow-Methode (certenroll.h)

Artikel
08/22/2023

Die ParentWindow-Eigenschaft gibt die ID des Fensters an und ruft sie ab, das von schlüsselbezogenen Benutzeroberflächendialogen verwendet wird.

Dies ist eine Eigenschaft mit Lese- und Schreibzugriff.

Syntax

HRESULT get_ParentWindow(
  LONG *pValue
);

Parameter

pValue

Rückgabewert

Keine

Bemerkungen

Dieser Eigenschaftswert wird von schlüsselbezogenen modalen Dialogfeldern für die Zertifikatregistrierungssteuerung verwendet, die Folgendes tun:

Weisen Sie einen Benutzer an, eine intelligente Karte einzufügen.
Anfordern einer smarten Karte Pinnummer
Anfordern der Schutzebene für einen neuen Schlüssel
Anfordern eines Benutzerkennworts vor dem Zugriff auf einen Schlüssel

Wenn Ihre Anwendung schlüsselbezogene modale Dialoge verwendet, wird empfohlen, diese Eigenschaft zu verwenden, um sicherzustellen, dass Das Fenster vor anderen Fenstern angezeigt wird und dass die angeforderte Aktion ausgeführt wird, bevor die Blockierung des Threads aufgehoben werden kann.

Sie können diese Eigenschaft festlegen, bevor Sie eine Initialisierungsmethode oder die Encode-Methode aufrufen. Wenn die Zertifikatanforderung geschachtelte Anforderungen enthält und Sie die ParentWindow-Eigenschaft für die Anforderung der obersten Ebene festlegen, wird sie automatisch an alle inneren Anforderungen weitergegeben. Sie können die -Eigenschaft jedoch manuell für jedes der inneren Objekte festlegen.

Bei einer PKCS #10-Anforderung wird der Eigenschaftswert aus dem zugeordneten IX509PrivateKey-Objekt abgerufen und angegeben, sofern der Schlüssel vorhanden ist. Bei einer PKCS #7- oder CMC-Anforderung wird die Fenster-ID für die innere Anforderung und alle Signaturzertifikate aktualisiert.

Anforderungen


Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	certenroll.h
DLL	CertEnroll.dll