X509CertificateRecipientClientCredential.SetScopedCertificate Metod

Definition

Anger ett certifikat från ett arkiv och lagrar det i en samling som indexeras av URL:en som anger omfånget.

Överlagringar

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

Anger ett certifikat efter ämnesnamn, plats för certifikatarkivet och certifikatarkivets namn och lagrar det i en samling som ska användas för den URL som anger omfånget.

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

Anger ett certifikat efter certifikatarkivplats, certifikatarkivets namn, typ av X.509-sökning och värde att söka efter och lagrar det i en samling som ska användas för den URL som anger omfånget.

SetScopedCertificate(String, StoreLocation, StoreName, Uri)

Källa:
X509CertificateRecipientClientCredential.cs
Källa:
X509CertificateRecipientClientCredential.cs
Källa:
X509CertificateRecipientClientCredential.cs

Anger ett certifikat efter ämnesnamn, plats för certifikatarkivet och certifikatarkivets namn och lagrar det i en samling som ska användas för den URL som anger omfånget.

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)

Parametrar

subjectName
String

Det fullständigt kvalificerade ämnesnamnet.

storeLocation
StoreLocation

Platsen för certifikatarkivet som tjänsten använder för att hämta tjänstcertifikatet.

storeName
StoreName

Namnet på X.509-certifikatarkivet som ska öppnas.

targetService
Uri

Den URL som anger omfånget.

Undantag

subjectName eller targetService är null.

Försökte ange när autentiseringsuppgifterna är skrivskyddade.

Exempel

Den här koden visar hur du anropar den här metoden.

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

Kommentarer

Värden för storeLocation ingår i StoreLocation uppräkningen:

  • LocalMachine: certifikatarkivet som tilldelats den lokala datorn.

  • CurrentUser: certifikatarkivet som används av den aktuella användaren (standard).

Om programmet körs under ett systemkonto finns certifikatet vanligtvis i LocalMachine. Om programmet körs under ett användarkonto finns certifikatet vanligtvis i CurrentUser.

Värden för storeName ingår i StoreName uppräkningen.

Gäller för

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

Källa:
X509CertificateRecipientClientCredential.cs
Källa:
X509CertificateRecipientClientCredential.cs
Källa:
X509CertificateRecipientClientCredential.cs

Anger ett certifikat efter certifikatarkivplats, certifikatarkivets namn, typ av X.509-sökning och värde att söka efter och lagrar det i en samling som ska användas för den URL som anger omfånget.

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)

Parametrar

storeLocation
StoreLocation

Platsen för certifikatarkivet som tjänsten använder för att hämta tjänstcertifikatet.

storeName
StoreName

Namnet på X.509-certifikatarkivet som ska öppnas.

findType
X509FindType

Typen av X.509-sökning som ska köras.

findValue
Object

Värdet att söka efter i X.509-certifikatarkivet.

targetService
Uri

Den URL som anger omfånget.

Undantag

findValue eller targetService är null.

Försökte ange när autentiseringsuppgifterna är skrivskyddade.

Exempel

Den här koden visar hur du anropar den här metoden.

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

Kommentarer

Värden för storeLocation ingår i StoreLocation uppräkningen:

  • LocalMachine: certifikatarkivet som tilldelats den lokala datorn.

  • CurrentUser: certifikatarkivet som används av den aktuella användaren (standard).

Om programmet körs under ett systemkonto finns certifikatet vanligtvis i LocalMachine. Om programmet körs under ett användarkonto finns certifikatet vanligtvis i CurrentUser.

Värden för storeName ingår i StoreName uppräkningen.

Värden för findType ingår i X509FindType uppräkningen.

Den vanligaste uppräkningen är FindBySubjectName, som gör en skiftlägeskänslig sökning på certifikatets ämnesnamn i det angivna arkivet. Detta kan vara en oprecis sökning. Om inga certifikat eller flera certifikat som matchar kriterierna hittas genereras ett InvalidOperationException .

Gäller för