Udostępnij za pośrednictwem

X509CertificateRecipientClientCredential.SetScopedCertificate Metoda

  • Odwołanie

Definicja

Przestrzeń nazw:
System.ServiceModel.Security
Zestaw:
System.ServiceModel.Primitives.dll
Zestaw:
System.ServiceModel.dll

Ustawia certyfikat z magazynu i przechowuje go w kolekcji indeksowanej przez adres URL, który ustawia zakres.

Przeciążenia

SetScopedCertificate(String, StoreLocation, StoreName, Uri)

Ustawia certyfikat według nazwy podmiotu, lokalizacji magazynu certyfikatów i nazwy magazynu certyfikatów oraz przechowuje go w kolekcji, która ma być używana dla adresu URL, który ustawia zakres.
SetScopedCertificate(StoreLocation, StoreName, X509FindType, Object, Uri)

Ustawia certyfikat według lokalizacji magazynu certyfikatów, nazwy magazynu certyfikatów, typu wyszukiwania X.509 i wartości do wyszukania i przechowuje go w kolekcji, która ma być używana dla adresu URL, który ustawia zakres.

SetScopedCertificate(String, StoreLocation, StoreName, Uri)

Ustawia certyfikat według nazwy podmiotu, lokalizacji magazynu certyfikatów i nazwy magazynu certyfikatów oraz przechowuje go w kolekcji, która ma być używana dla adresu URL, który ustawia zakres.

public:
 void SetScopedCertificate(System::String ^ subjectName, System::Security::Cryptography::X509Certificates::StoreLocation storeLocation, System::Security::Cryptography::X509Certificates::StoreName storeName, Uri ^ targetService);
public void SetScopedCertificate (string subjectName, System.Security.Cryptography.X509Certificates.StoreLocation storeLocation, System.Security.Cryptography.X509Certificates.StoreName storeName, Uri targetService);
member this.SetScopedCertificate : string * System.Security.Cryptography.X509Certificates.StoreLocation * System.Security.Cryptography.X509Certificates.StoreName * Uri -> unit
Public Sub SetScopedCertificate (subjectName As String, storeLocation As StoreLocation, storeName As StoreName, targetService As Uri)

Parametry

subjectName
String

W pełni kwalifikowana nazwa podmiotu.

storeLocation
StoreLocation

Lokalizacja magazynu certyfikatów używanego przez usługę do uzyskania certyfikatu usługi.

storeName
StoreName

Nazwa magazynu certyfikatów X.509 do otwarcia.

targetService
Uri

Adres URL, który ustawia zakres.

Wyjątki

ArgumentNullException

subjectName lub targetService ma wartość null.

InvalidOperationException

Podjęto próbę ustawienia, gdy poświadczenie jest tylko do odczytu.

Przykłady

Ten kod pokazuje, jak wywołać tę metodę.

public void snippet25(CalculatorClient cc)
{
    X509CertificateRecipientClientCredential rcc = cc.ClientCredentials.ServiceCertificate;
    rcc.SetScopedCertificate("http://fabrikam.com/sts",
                             StoreLocation.CurrentUser,
                             StoreName.TrustedPeople,
                             new Uri("http://fabrikam.com"));
}

Uwagi

Wartości dla storeLocation elementu są uwzględniane w wyliczenie StoreLocation :

  • LocalMachine: magazyn certyfikatów przypisany do komputera lokalnego.

  • CurrentUser: magazyn certyfikatów używany przez bieżącego użytkownika (ustawienie domyślne).

Jeśli aplikacja jest uruchomiona na koncie systemowym, certyfikat zazwyczaj znajduje się w elemecie LocalMachine. Jeśli aplikacja jest uruchomiona na koncie użytkownika, certyfikat zazwyczaj znajduje się w elemecie CurrentUser.

Wartości dla storeName są uwzględniane w wyliczenie StoreName .

Dotyczy

SetScopedCertificate(StoreLocation, StoreName, X509FindType, Object, Uri)

Ustawia certyfikat według lokalizacji magazynu certyfikatów, nazwy magazynu certyfikatów, typu wyszukiwania X.509 i wartości do wyszukania i przechowuje go w kolekcji, która ma być używana dla adresu URL, który ustawia zakres.

public:
 void SetScopedCertificate(System::Security::Cryptography::X509Certificates::StoreLocation storeLocation, System::Security::Cryptography::X509Certificates::StoreName storeName, System::Security::Cryptography::X509Certificates::X509FindType findType, System::Object ^ findValue, Uri ^ targetService);
public void SetScopedCertificate (System.Security.Cryptography.X509Certificates.StoreLocation storeLocation, System.Security.Cryptography.X509Certificates.StoreName storeName, System.Security.Cryptography.X509Certificates.X509FindType findType, object findValue, Uri targetService);
member this.SetScopedCertificate : System.Security.Cryptography.X509Certificates.StoreLocation * System.Security.Cryptography.X509Certificates.StoreName * System.Security.Cryptography.X509Certificates.X509FindType * obj * Uri -> unit
Public Sub SetScopedCertificate (storeLocation As StoreLocation, storeName As StoreName, findType As X509FindType, findValue As Object, targetService As Uri)

Parametry

storeLocation
StoreLocation

Lokalizacja magazynu certyfikatów używanego przez usługę do uzyskania certyfikatu usługi.

storeName
StoreName

Nazwa magazynu certyfikatów X.509 do otwarcia.

findType
X509FindType

Typ wyszukiwania X.509 do wykonania.

findValue
Object

Wartość do wyszukania w magazynie certyfikatów X.509.

targetService
Uri

Adres URL, który ustawia zakres.

Wyjątki

ArgumentNullException

findValue lub targetService ma wartość null.

InvalidOperationException

Podjęto próbę ustawienia, gdy poświadczenie jest tylko do odczytu.

Przykłady

Ten kod pokazuje, jak wywołać tę metodę.

public void snippet20(CalculatorClient client)
{
    X509CertificateRecipientClientCredential rcc = client.ClientCredentials.ServiceCertificate;
    rcc.SetScopedCertificate(StoreLocation.CurrentUser,
                             StoreName.TrustedPeople,
                             X509FindType.FindBySubjectName,
                             "FabrikamSTS",
                             new Uri("http://fabrikam.com/sts"));
}

rcc.SetScopedCertificate(StoreLocation.CurrentUser, _
            StoreName.TrustedPeople, _
            X509FindType.FindBySubjectName, _
            "FabrikamSTS", _
            New Uri("http://fabrikam.com/sts"))

Uwagi

Wartości dla storeLocation elementu są uwzględniane w wyliczenie StoreLocation :

  • LocalMachine: magazyn certyfikatów przypisany do komputera lokalnego.

  • CurrentUser: magazyn certyfikatów używany przez bieżącego użytkownika (ustawienie domyślne).

Jeśli aplikacja jest uruchomiona na koncie systemowym, certyfikat zazwyczaj znajduje się w elemecie LocalMachine. Jeśli aplikacja jest uruchomiona na koncie użytkownika, certyfikat zazwyczaj znajduje się w elemecie CurrentUser.

Wartości dla storeName są uwzględniane w wyliczenie StoreName .

Wartości dla findType są uwzględniane w wyliczenie X509FindType .

Najczęściej używane wyliczenie to FindBySubjectName, co umożliwia wyszukiwanie bez uwzględniania wielkości liter w nazwie podmiotu certyfikatów w określonym magazynie. Może to być nieprecyzyjne wyszukiwanie. Jeśli nie zostaną znalezione żadne certyfikaty lub wiele certyfikatów spełniających kryteria, zostanie zgłoszony błąd InvalidOperationException .

Dotyczy