X509CertificateRecipientClientCredential.SetScopedCertificate Methode

Definitie

Naamruimte:: System.ServiceModel.Security

Assembly:: System.ServiceModel.dll

Belangrijk

Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.

Hiermee stelt u een certificaat uit een archief in en slaat u het op in een verzameling die wordt geïndexeerd door de URL waarmee het bereik wordt ingesteld.

Overloads

Name	Description
SetScopedCertificate(String, StoreLocation, StoreName, Uri)	Hiermee stelt u een certificaat in op onderwerpnaam, de locatie van het certificaatarchief en de naam van het certificaatarchief en slaat u het op in een verzameling die moet worden gebruikt voor de URL waarmee het bereik wordt ingesteld.
SetScopedCertificate(StoreLocation, StoreName, X509FindType, Object, Uri)	Hiermee stelt u een certificaat in op basis van de locatie van het certificaatarchief, de naam van het certificaatarchief, het type X.509-zoekopdracht en de waarde waarnaar u wilt zoeken en slaat u het op in een verzameling die moet worden gebruikt voor de URL waarmee het bereik wordt ingesteld.

SetScopedCertificate(String, StoreLocation, StoreName, Uri)

Hiermee stelt u een certificaat in op onderwerpnaam, de locatie van het certificaatarchief en de naam van het certificaatarchief en slaat u het op in een verzameling die moet worden gebruikt voor de URL waarmee het bereik wordt ingesteld.

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)

Parameters

subjectName: String

De volledig gekwalificeerde onderwerpnaam.

storeLocation: StoreLocation

De locatie van het certificaatarchief dat door de service wordt gebruikt om het servicecertificaat te verkrijgen.

storeName: StoreName

De naam van het X.509-certificaatarchief dat moet worden geopend.

targetService: Uri

De URL waarmee het bereik wordt ingesteld.

Uitzonderingen

ArgumentNullException

subjectName of targetService is null.

InvalidOperationException

Er is geprobeerd om in te stellen wanneer de referentie het kenmerk Alleen-lezen heeft.

Voorbeelden

Deze code laat zien hoe u deze methode aanroept.

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

Opmerkingen

Waarden voor storeLocation worden opgenomen in de StoreLocation opsomming:

LocalMachine: het certificaatarchief dat is toegewezen aan de lokale computer.
CurrentUser: het certificaatarchief dat wordt gebruikt door de huidige gebruiker (standaard).

Als de toepassing wordt uitgevoerd onder een systeemaccount, bevindt het certificaat zich meestal in LocalMachine. Als de toepassing wordt uitgevoerd onder een gebruikersaccount, bevindt het certificaat zich meestal in CurrentUser.

Waarden voor storeName worden opgenomen in de StoreName opsomming.

Van toepassing op

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

Hiermee stelt u een certificaat in op basis van de locatie van het certificaatarchief, de naam van het certificaatarchief, het type X.509-zoekopdracht en de waarde waarnaar u wilt zoeken en slaat u het op in een verzameling die moet worden gebruikt voor de URL waarmee het bereik wordt ingesteld.

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)

Parameters

storeLocation: StoreLocation

De locatie van het certificaatarchief dat door de service wordt gebruikt om het servicecertificaat te verkrijgen.

storeName: StoreName

De naam van het X.509-certificaatarchief dat moet worden geopend.

findType: X509FindType

Het type X.509-zoekopdracht dat moet worden uitgevoerd.

findValue: Object

De waarde die moet worden gezocht in het X.509-certificaatarchief.

targetService: Uri

De URL waarmee het bereik wordt ingesteld.

Uitzonderingen

ArgumentNullException

findValue of targetService is null.

InvalidOperationException

Er is geprobeerd om in te stellen wanneer de referentie het kenmerk Alleen-lezen heeft.

Voorbeelden

Deze code laat zien hoe u deze methode aanroept.

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

Opmerkingen

Waarden voor storeLocation worden opgenomen in de StoreLocation opsomming:

LocalMachine: het certificaatarchief dat is toegewezen aan de lokale computer.
CurrentUser: het certificaatarchief dat wordt gebruikt door de huidige gebruiker (standaard).

Waarden voor storeName worden opgenomen in de StoreName opsomming.

Waarden voor findType worden opgenomen in de X509FindType opsomming.

De meest gebruikte opsomming is FindBySubjectName, die een hoofdlettergevoelige zoekopdracht doet op de onderwerpnaam van certificaten in het opgegeven archief. Dit kan een onnauwkeurig zoeken zijn. Als er geen certificaten of meerdere certificaten worden gevonden die voldoen aan de criteria, wordt er een InvalidOperationException gegenereerd.

Van toepassing op

Feedback

Is deze pagina nuttig?