X509CertificateRecipientClientCredential.SetDefaultCertificate 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.
Gibt das Standardzertifikat an, das für den Dienst verwendet werden soll.
Überlädt
| SetDefaultCertificate(String, StoreLocation, StoreName) |
Gibt das Standardzertifikat an, das für den Dienst verwendet werden soll. Bei Bindungen mit Zertifikat-basierter Nachrichtensicherheit wird dieses Zertifikat zum Verschlüsseln von Nachrichten für den Dienst sowie für die Signierung von Antworten an den Client verwendet. |
| SetDefaultCertificate(StoreLocation, StoreName, X509FindType, Object) |
Gibt das Standardzertifikat an, das für den Dienst verwendet werden soll. Bei Bindungen mit Zertifikat-basierter Nachrichtensicherheit wird dieses Zertifikat zum Verschlüsseln von Nachrichten für den Dienst sowie für die Signierung von Antworten an den Client verwendet. |
Hinweise
Diese Methoden rufen ein Zertifikat vom Speicher am angegebenen Speicherort ab, das mit den angegebenen Parametern übereinstimmt.
Bei Bindungen mit Zertifikat-basierter Nachrichtensicherheit wird dieses Zertifikat zum Verschlüsseln von Nachrichten für den Dienst sowie für die Signierung von Antworten an den Client verwendet.
SetDefaultCertificate(String, StoreLocation, StoreName)
Gibt das Standardzertifikat an, das für den Dienst verwendet werden soll. Bei Bindungen mit Zertifikat-basierter Nachrichtensicherheit wird dieses Zertifikat zum Verschlüsseln von Nachrichten für den Dienst sowie für die Signierung von Antworten an den Client verwendet.
public:
void SetDefaultCertificate(System::String ^ subjectName, System::Security::Cryptography::X509Certificates::StoreLocation storeLocation, System::Security::Cryptography::X509Certificates::StoreName storeName);public void SetDefaultCertificate (string subjectName, System.Security.Cryptography.X509Certificates.StoreLocation storeLocation, System.Security.Cryptography.X509Certificates.StoreName storeName);member this.SetDefaultCertificate : string * System.Security.Cryptography.X509Certificates.StoreLocation * System.Security.Cryptography.X509Certificates.StoreName -> unitPublic Sub SetDefaultCertificate (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 Dienstzertifikats verwendet.
- storeName
- StoreName
Der Name des X.509-Zertifikatsspeichers, der geöffnet werden soll.
Ausnahmen
subjectName ist null.
Dies wurde versucht festzulegen, obwohl die Anmeldeinformationen schreibgeschützt sind.
Beispiele
Im folgenden Code wird diese Methode verwendet, um ein zu verwendendes X.509-Zertifikat anzugeben.
public void snippet23(CalculatorClient cc)
{
X509CertificateRecipientClientCredential rcc = cc.ClientCredentials.ServiceCertificate;
rcc.SetDefaultCertificate("http://fabrikam.com/sts",
StoreLocation.CurrentUser,
StoreName.TrustedPeople);
}
Hinweise
Diese Methode ruft ein Zertifikat vom Speicher am angegebenen Speicherort ab, das mit dem subjectName-Parameter übereinstimmt.
Werte für storeLocation sind in der StoreLocation-Enumeration enthalten:
LocalMachine: Der Zertifikatspeicher, der dem lokalen Computer zugewiesen ist.
CurrentUser: Der vom aktuellen Benutzer verwendete Zertifikatspeicher (Standard).
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.
Gilt für:
SetDefaultCertificate(StoreLocation, StoreName, X509FindType, Object)
Gibt das Standardzertifikat an, das für den Dienst verwendet werden soll. Bei Bindungen mit Zertifikat-basierter Nachrichtensicherheit wird dieses Zertifikat zum Verschlüsseln von Nachrichten für den Dienst sowie für die Signierung von Antworten an den Client verwendet.
public:
void SetDefaultCertificate(System::Security::Cryptography::X509Certificates::StoreLocation storeLocation, System::Security::Cryptography::X509Certificates::StoreName storeName, System::Security::Cryptography::X509Certificates::X509FindType findType, System::Object ^ findValue);public void SetDefaultCertificate (System.Security.Cryptography.X509Certificates.StoreLocation storeLocation, System.Security.Cryptography.X509Certificates.StoreName storeName, System.Security.Cryptography.X509Certificates.X509FindType findType, object findValue);member this.SetDefaultCertificate : System.Security.Cryptography.X509Certificates.StoreLocation * System.Security.Cryptography.X509Certificates.StoreName * System.Security.Cryptography.X509Certificates.X509FindType * obj -> unitPublic Sub SetDefaultCertificate (storeLocation As StoreLocation, storeName As StoreName, findType As X509FindType, findValue As Object)Parameter
- storeLocation
- StoreLocation
Der Speicherort des Zertifikatspeichers, den der Dienst zum Abrufen des Dienstzertifikats 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.
Ausnahmen
findValue ist null.
Dies wurde versucht festzulegen, obwohl die Anmeldeinformationen schreibgeschützt sind.
Beispiele
Im folgenden Code wird diese Methode verwendet, um ein zu verwendendes X.509-Zertifikat anzugeben.
public void snippet22(CalculatorClient cc)
{
X509CertificateRecipientClientCredential rcc = cc.ClientCredentials.ServiceCertificate;
rcc.SetDefaultCertificate(StoreLocation.CurrentUser,
StoreName.TrustedPeople,
X509FindType.FindBySubjectName,
"FabrikamSTS");
}
Hinweise
Diese Methode ruft ein Zertifikat vom Speicher am angegebenen Speicherort ab, das mit dem findType-Parameter und findValue-Parameter übereinstimmt.
Werte für storeLocation sind in der StoreLocation-Enumeration enthalten:
LocalMachine: Der Zertifikatspeicher, der dem lokalen Computer zugewiesen ist.
CurrentUser: Der vom aktuellen Benutzer verwendete Zertifikatspeicher (Standard).
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.
