IX509CertificateRequest::get_UIContextMessage-Methode (certenroll.h)
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 |