Freigeben über


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

Weitere Informationen

IX509CertificateRequest

IX509CertificateRequestCertificate

IX509CertificateRequestCmc

IX509CertificateRequestPkcs10

IX509CertificateRequestPkcs7

IX509SignatureInformation