X509CertificateInitiatorServiceCredential.SetCertificate Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Legt das Zertifikat fest mit dem die vom Dienst an den Client gesendeten Nachrichten verschlüsselt werden. Diese Einstellung wird nur von Bindungen verwendet, die mit dem MutualCertificateDuplex-Authentifizierungsmodus für die Nachrichtensicherheit konfiguriert sind.
Überlädt
| SetCertificate(String, StoreLocation, StoreName) |
Ermöglicht Ihnen, dem Client das Zertifikat für die Verschlüsselung von Nachrichten zu nennen, indem Sie den definierten Betreffnamen angeben. Diese Einstellung wird nur von Bindungen verwendet, die mit dem |
| SetCertificate(StoreLocation, StoreName, X509FindType, Object) |
Gibt das Zertifikat an, das zum Verschlüsseln von Nachrichten für den Client verwendet werden soll. Diese Einstellung wird nur von Bindungen verwendet, die mit dem |
SetCertificate(String, StoreLocation, StoreName)
Ermöglicht Ihnen, dem Client das Zertifikat für die Verschlüsselung von Nachrichten zu nennen, indem Sie den definierten Betreffnamen angeben. Diese Einstellung wird nur von Bindungen verwendet, die mit dem MutualCertificateDuplex-Authentifizierungsmodus für die Nachrichtensicherheit konfiguriert sind.
public:
void SetCertificate(System::String ^ subjectName, System::Security::Cryptography::X509Certificates::StoreLocation storeLocation, System::Security::Cryptography::X509Certificates::StoreName storeName);public void SetCertificate (string subjectName, System.Security.Cryptography.X509Certificates.StoreLocation storeLocation, System.Security.Cryptography.X509Certificates.StoreName storeName);member this.SetCertificate : string * System.Security.Cryptography.X509Certificates.StoreLocation * System.Security.Cryptography.X509Certificates.StoreName -> unitPublic Sub SetCertificate (subjectName As String, storeLocation As StoreLocation, storeName As StoreName)Parameter
- subjectName
- String
Distinguished Name des Antragstellers.
- storeLocation
- StoreLocation
Der Speicherort des Zertifikatsspeichers, den der Dienst zum Abrufen des Zertifikats verwendet.
- storeName
- StoreName
Der Name des X.509-Zertifikatsspeichers, der geöffnet werden soll.
Beispiele
Der folgende Code zeigt, wie diese Methode verwendet wird, um das Zertifikat festzulegen.
Hinweise
Weitere Informationen zum subjectName-Parameter finden Sie unter SubjectName.
Werte für storeLocation sind in der StoreLocation-Enumeration enthalten:
LocalMachine: Der dem lokalen Computer zugewiesene Zertifikatsspeicher (Standardeinstellung).
CurrentUser: Der vom aktuellen Benutzer verwendete Zertifikatsspeicher.
Wenn die Clientanwendung über ein Systemkonto ausgeführt wird, befindet sich das Zertifikat in der Regel in LocalMachine. Wenn die Clientanwendung über ein Benutzerkonto ausgeführt wird, befindet sich das Zertifikat in der Regel in CurrentUser.
Werte für storeName sind in der StoreName-Enumeration enthalten.
Gilt für:
SetCertificate(StoreLocation, StoreName, X509FindType, Object)
Gibt das Zertifikat an, das zum Verschlüsseln von Nachrichten für den Client verwendet werden soll. Diese Einstellung wird nur von Bindungen verwendet, die mit dem MutualCertificateDuplex-Authentifizierungsmodus für die Nachrichtensicherheit konfiguriert sind.
public:
void SetCertificate(System::Security::Cryptography::X509Certificates::StoreLocation storeLocation, System::Security::Cryptography::X509Certificates::StoreName storeName, System::Security::Cryptography::X509Certificates::X509FindType findType, System::Object ^ findValue);public void SetCertificate (System.Security.Cryptography.X509Certificates.StoreLocation storeLocation, System.Security.Cryptography.X509Certificates.StoreName storeName, System.Security.Cryptography.X509Certificates.X509FindType findType, object findValue);member this.SetCertificate : System.Security.Cryptography.X509Certificates.StoreLocation * System.Security.Cryptography.X509Certificates.StoreName * System.Security.Cryptography.X509Certificates.X509FindType * obj -> unitPublic Sub SetCertificate (storeLocation As StoreLocation, storeName As StoreName, findType As X509FindType, findValue As Object)Parameter
- storeLocation
- StoreLocation
Der Speicherort des Zertifikatsspeichers, den der Dienst zum Abrufen des Zertifikats verwendet.
- storeName
- StoreName
Der Name des X.509-Zertifikatsspeichers, der geöffnet werden soll.
- findType
- X509FindType
Der Typ der X.509-Suche, der ausgeführt werden soll.
- findValue
- Object
Der Wert, nach dem im X.509-Zertifikatspeicher gesucht werden soll.
Beispiele
Der folgende Code zeigt, wie diese Methode verwendet wird, um das Zertifikat festzulegen.
Hinweise
Werte für storeLocation sind in der StoreLocation-Enumeration enthalten:
LocalMachine: Der dem lokalen Computer zugewiesene Zertifikatsspeicher (Standardeinstellung).
CurrentUser: Der vom aktuellen Benutzer verwendete Zertifikatsspeicher.
Wenn die Anwendung über ein Systemkonto ausgeführt wird, befindet sich das Zertifikat in der Regel in LocalMachine. Wenn die Anwendung über ein Benutzerkonto ausgeführt wird, befindet sich das Zertifikat in der Regel in CurrentUser.
Werte für storeName sind in der StoreName-Enumeration enthalten.
Werte für findType sind in der X509FindType-Enumeration enthalten.
Die am häufigsten verwendete Enumeration ist FindBySubjectName, die eine Suche in den Betreffnamen der Zertifikate im angegebenen Speicher durchführt, wobei zwischen Groß- und Kleinschreibung unterschieden wird. Dies kann eine ungenaue Suche sein. Wenn keine Zertifikate oder mehrere Zertifikate, die mit den Kriterien übereinstimmen, gefunden werden, wird InvalidOperationException ausgegeben.
