X509CertificateRecipientClientCredential.SetScopedCertificate Methode

Definition

Legt ein Zertifikat aus einem Speicher fest und speichert es in einer Auflistung, die von der URL indiziert wird, die den Bereich festlegt.

Überlädt

Name Beschreibung
SetScopedCertificate(String, StoreLocation, StoreName, Uri)

Legt ein Zertifikat nach Antragstellername, Speicherort des Zertifikatspeichers und Zertifikatspeichernamen fest und speichert es in einer Auflistung, die für die URL verwendet werden soll, die den Bereich festlegt.

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

Legt ein Zertifikat nach Zertifikatspeicherort, Zertifikatspeichername, Typ der X.509-Suche und Wert fest, nach der gesucht werden soll, und speichert es in einer Auflistung, die für die URL verwendet werden soll, die den Bereich festlegt.

SetScopedCertificate(String, StoreLocation, StoreName, Uri)

Quelle:
X509CertificateRecipientClientCredential.cs
Quelle:
X509CertificateRecipientClientCredential.cs
Quelle:
X509CertificateRecipientClientCredential.cs

Legt ein Zertifikat nach Antragstellername, Speicherort des Zertifikatspeichers und Zertifikatspeichernamen fest und speichert es in einer Auflistung, die für die URL verwendet werden soll, die den Bereich festlegt.

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)

Parameter

subjectName
String

Der vollqualifizierte Antragstellername.

storeLocation
StoreLocation

Der Speicherort des Zertifikatspeichers, den der Dienst zum Abrufen des Dienstzertifikats verwendet.

storeName
StoreName

Der Name des zu öffnenden X.509-Zertifikatspeichers.

targetService
Uri

Die URL, die den Bereich festlegt.

Ausnahmen

subjectName oder targetService ist null.

Es wurde versucht, festzulegen, wann die Anmeldeinformationen schreibgeschützt sind.

Beispiele

Dieser Code zeigt, wie diese Methode aufgerufen wird.

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"));
}

Hinweise

Werte für storeLocation die Enumeration sind enthalten StoreLocation :

  • LocalMachine: der dem lokalen Computer zugewiesene Zertifikatspeicher.

  • CurrentUser: der vom aktuellen Benutzer verwendete Zertifikatspeicher (Standard).

Wenn die Anwendung unter einem Systemkonto ausgeführt wird, befindet sich das Zertifikat in der Regel in LocalMachine. Wenn die Anwendung unter einem Benutzerkonto ausgeführt wird, befindet sich das Zertifikat in der Regel in CurrentUser.

Die Werte für storeName diese sind in der StoreName Enumeration enthalten.

Gilt für:

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

Quelle:
X509CertificateRecipientClientCredential.cs
Quelle:
X509CertificateRecipientClientCredential.cs
Quelle:
X509CertificateRecipientClientCredential.cs

Legt ein Zertifikat nach Zertifikatspeicherort, Zertifikatspeichername, Typ der X.509-Suche und Wert fest, nach der gesucht werden soll, und speichert es in einer Auflistung, die für die URL verwendet werden soll, die den Bereich festlegt.

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)

Parameter

storeLocation
StoreLocation

Der Speicherort des Zertifikatspeichers, den der Dienst zum Abrufen des Dienstzertifikats verwendet.

storeName
StoreName

Der Name des zu öffnenden X.509-Zertifikatspeichers.

findType
X509FindType

Der Typ der X.509-Suche, die ausgeführt werden soll.

findValue
Object

Der Wert, nach dem im X.509-Zertifikatspeicher gesucht werden soll.

targetService
Uri

Die URL, die den Bereich festlegt.

Ausnahmen

findValue oder targetService ist null.

Es wurde versucht, festzulegen, wann die Anmeldeinformationen schreibgeschützt sind.

Beispiele

Dieser Code zeigt, wie diese Methode aufgerufen wird.

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"))

Hinweise

Werte für storeLocation die Enumeration sind enthalten StoreLocation :

  • LocalMachine: der dem lokalen Computer zugewiesene Zertifikatspeicher.

  • CurrentUser: der vom aktuellen Benutzer verwendete Zertifikatspeicher (Standard).

Wenn die Anwendung unter einem Systemkonto ausgeführt wird, befindet sich das Zertifikat in der Regel in LocalMachine. Wenn die Anwendung unter einem Benutzerkonto ausgeführt wird, befindet sich das Zertifikat in der Regel in CurrentUser.

Die Werte für storeName diese sind in der StoreName Enumeration enthalten.

Die Werte für findType diese sind in der X509FindType Enumeration enthalten.

Die am häufigsten verwendete Aufzählung ist FindBySubjectName, bei der bei der Suche nach dem Antragstellernamen von Zertifikaten im angegebenen Speicher die Groß-/Kleinschreibung nicht beachtet wird. Dies kann eine ungenaue Suche sein. Wenn keine Zertifikate oder mehrere Zertifikate gefunden werden, die den Kriterien entsprechen, wird ein InvalidOperationException Fehler ausgelöst.

Gilt für: