X509CertificateInitiatorServiceCredential.SetCertificate Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Nastaví certifikát, který se má použít k šifrování zpráv odeslaných službou klientovi. Toto nastavení používají pouze vazby, které jsou nakonfigurované s režimem MutualCertificateDuplex ověřování zabezpečení zpráv.
Přetížení
| SetCertificate(String, StoreLocation, StoreName) |
Umožňuje určit certifikát, který se má použít k šifrování zpráv pro klienta, zadáním rozlišujícího názvu předmětu. Toto nastavení používají pouze vazby, které jsou nakonfigurované s režimem |
| SetCertificate(StoreLocation, StoreName, X509FindType, Object) |
Určuje certifikát, který se má použít k šifrování zpráv pro klienta. Toto nastavení používají pouze vazby, které jsou nakonfigurované s režimem |
SetCertificate(String, StoreLocation, StoreName)
Umožňuje určit certifikát, který se má použít k šifrování zpráv pro klienta, zadáním rozlišujícího názvu předmětu. Toto nastavení používají pouze vazby, které jsou nakonfigurované s režimem MutualCertificateDuplex ověřování zabezpečení zpráv.
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
Rozlišující název předmětu.
- storeLocation
- StoreLocation
Umístění úložiště certifikátů, které služba používá k získání certifikátu.
- storeName
- StoreName
Název úložiště certifikátů X.509, které se má otevřít.
Příklady
Následující kód ukazuje, jak pomocí této metody nastavit certifikát.
Poznámky
Další informace o parametru najdete v subjectName tématu SubjectName.
Hodnoty pro storeLocation jsou zahrnuty ve výčtu StoreLocation :
LocalMachine: úložiště certifikátů přiřazené k místnímu počítači (výchozí).
CurrentUser: úložiště certifikátů používané aktuálním uživatelem.
Pokud klientská aplikace běží pod systémovým účtem, je certifikát obvykle v LocalMachine. Pokud klientská aplikace běží pod uživatelským účtem, je certifikát obvykle v CurrentUser.
Hodnoty pro storeName jsou zahrnuty ve výčtu StoreName .
Platí pro
SetCertificate(StoreLocation, StoreName, X509FindType, Object)
Určuje certifikát, který se má použít k šifrování zpráv pro klienta. Toto nastavení používají pouze vazby, které jsou nakonfigurované s režimem MutualCertificateDuplex ověřování zabezpečení zpráv.
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
Umístění úložiště certifikátů, které služba používá k získání certifikátu.
- storeName
- StoreName
Název úložiště certifikátů X.509, které se má otevřít.
- findType
- X509FindType
Typ vyhledávání X.509, který se má provést.
- findValue
- Object
Hodnota, kterou chcete vyhledat v úložišti certifikátů X.509.
Příklady
Následující kód ukazuje, jak pomocí této metody nastavit certifikát.
Poznámky
Hodnoty pro storeLocation jsou zahrnuty ve výčtu StoreLocation :
LocalMachine: úložiště certifikátů přiřazené k místnímu počítači (výchozí).
CurrentUser: úložiště certifikátů používané aktuálním uživatelem.
Pokud je aplikace spuštěná pod systémovým účtem, je certifikát obvykle v LocalMachine. Pokud je aplikace spuštěná pod uživatelským účtem, je certifikát obvykle v CurrentUser.
Hodnoty pro storeName jsou zahrnuty ve výčtu StoreName .
Hodnoty pro findType jsou zahrnuty ve výčtu X509FindType .
Nejčastěji používaný výčet je FindBySubjectName, který provádí vyhledávání bez rozlišování velkých a malých písmen v názvu subjektu certifikátů v zadaném úložišti. Může se jednat o nepřesné hledání. Pokud nejsou nalezeny žádné certifikáty nebo více certifikátů, které splňují kritéria, InvalidOperationException je vyvolán.
