IX509CertificateRequest::get_UIContextMessage-Methode (certenroll.h)

Artikel
02/28/2024

Die UIContextMessage-Eigenschaft gibt eine Kontextzeichenfolge an, die auf der Benutzeroberfläche angezeigt werden soll.

Dies ist eine Eigenschaft mit Lese- und Schreibzugriff.

Syntax

HRESULT get_UIContextMessage(
  BSTR *pValue
);

Parameter

pValue

Rückgabewert

Keine

Bemerkungen

Sie können diese Eigenschaft festlegen, bevor Sie eine Initialisierungsmethode oder die Encode-Methode aufrufen. Bei einer PKCS #10-Anforderung wird der Eigenschaftswert von abgerufen und im zugeordneten IX509PrivateKey-Objekt angegeben, wenn der Schlüssel vorhanden ist. Bei einer PKCS #7- oder CMC-Anforderung wird der Eigenschaftswert für die innere Anforderung und alle Signaturzertifikate aktualisiert.

Die Kontextzeichenfolge sollte zusätzliche Informationen zu einer Aktion enthalten. Wenn beispielsweise die Benutzeroberfläche den Benutzer anweist, eine Smartcard-PIN einzugeben, kann die Kontextzeichenfolge angeben, dass eine PIN verwendet wird, um die Identität des Benutzers zu überprüfen, damit die Anforderung signiert werden kann.

Anforderungen

Anforderung	Wert
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