X509CertificateInitiatorServiceCredential.SetCertificate Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Ustawia certyfikat używany do szyfrowania komunikatów wysyłanych do klienta przez usługę. To ustawienie jest używane tylko przez powiązania skonfigurowane z MutualCertificateDuplex trybem uwierzytelniania zabezpieczeń wiadomości.
Przeciążenia
| SetCertificate(String, StoreLocation, StoreName) |
Umożliwia określenie certyfikatu używanego do szyfrowania komunikatów dla klienta przez określenie nazwy wyróżniającej podmiotu. To ustawienie jest używane tylko przez powiązania skonfigurowane z |
| SetCertificate(StoreLocation, StoreName, X509FindType, Object) |
Określa certyfikat, który ma być używany do szyfrowania komunikatów dla klienta. To ustawienie jest używane tylko przez powiązania skonfigurowane z |
SetCertificate(String, StoreLocation, StoreName)
Umożliwia określenie certyfikatu używanego do szyfrowania komunikatów dla klienta przez określenie nazwy wyróżniającej podmiotu. To ustawienie jest używane tylko przez powiązania skonfigurowane z MutualCertificateDuplex trybem uwierzytelniania zabezpieczeń wiadomości.
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)Parametry
- subjectName
- String
Nazwa wyróżniająca podmiotu.
- storeLocation
- StoreLocation
Lokalizacja magazynu certyfikatów używanego przez usługę do uzyskiwania certyfikatu.
- storeName
- StoreName
Nazwa magazynu certyfikatów X. 509 do otwarcia.
Przykłady
Poniższy kod pokazuje, jak używać tej metody do ustawiania certyfikatu.
Uwagi
Aby uzyskać więcej informacji na temat subjectName parametru, zobacz SubjectName .
Wartości dla storeLocation są zawarte w StoreLocation wyliczeniu:
LocalMachine: Magazyn certyfikatów przypisany do komputera lokalnego (domyślnie).
CurrentUser: Magazyn certyfikatów używany przez bieżącego użytkownika.
Jeśli aplikacja kliencka jest uruchomiona na koncie systemowym, certyfikat zazwyczaj znajduje się w temacie LocalMachine . Jeśli aplikacja kliencka jest uruchomiona w ramach konta użytkownika, certyfikat zazwyczaj znajduje się w temacie CurrentUser .
Wartości dla storeName są zawarte w StoreName wyliczeniu.
Dotyczy
SetCertificate(StoreLocation, StoreName, X509FindType, Object)
Określa certyfikat, który ma być używany do szyfrowania komunikatów dla klienta. To ustawienie jest używane tylko przez powiązania skonfigurowane z MutualCertificateDuplex trybem uwierzytelniania zabezpieczeń wiadomości.
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)Parametry
- storeLocation
- StoreLocation
Lokalizacja magazynu certyfikatów używanego przez usługę do uzyskiwania certyfikatu.
- storeName
- StoreName
Nazwa magazynu certyfikatów X. 509 do otwarcia.
- findType
- X509FindType
Typ wyszukiwania X. 509, który ma zostać wykonany.
- findValue
- Object
Wartość do wyszukania w magazynie certyfikatów X. 509.
Przykłady
Poniższy kod pokazuje, jak używać tej metody do ustawiania certyfikatu.
Uwagi
Wartości dla storeLocation są zawarte w StoreLocation wyliczeniu:
LocalMachine: Magazyn certyfikatów przypisany do komputera lokalnego (domyślnie).
CurrentUser: Magazyn certyfikatów używany przez bieżącego użytkownika.
Jeśli aplikacja działa w ramach konta systemowego, certyfikat zazwyczaj znajduje się w temacie LocalMachine . Jeśli aplikacja jest uruchomiona w ramach konta użytkownika, certyfikat zazwyczaj znajduje się w temacie CurrentUser .
Wartości dla storeName są zawarte w StoreName wyliczeniu.
Wartości dla findType są zawarte w X509FindType wyliczeniu.
Najczęściej używanym wyliczeniem jest FindBySubjectName , co oznacza, że wyszukiwanie w nazwie podmiotu certyfikatów w określonym sklepie nie uwzględnia wielkości liter. Może to być nieprecyzyjne wyszukiwanie. Jeśli nie zostaną znalezione żadne certyfikaty lub wiele certyfikatów zgodnych z kryteriami, InvalidOperationException jest zgłaszany.