IChannelCredentials Interface

Definitie

Naamruimte:
System.ServiceModel.ComIntegration
Assembly:
System.ServiceModel.dll

Een interface waarmee bepaalde beveiligingsfuncties op een serviceproxy kunnen worden ingesteld.

public interface class IChannelCredentials
[System.Runtime.InteropServices.Guid("181b448c-c17c-4b17-ac6d-06699b93198f")]
[System.Runtime.InteropServices.InterfaceType(System.Runtime.InteropServices.ComInterfaceType.InterfaceIsIDispatch)]
public interface IChannelCredentials
[<System.Runtime.InteropServices.Guid("181b448c-c17c-4b17-ac6d-06699b93198f")>]
[<System.Runtime.InteropServices.InterfaceType(System.Runtime.InteropServices.ComInterfaceType.InterfaceIsIDispatch)>]
type IChannelCredentials = interface
Public Interface IChannelCredentials
Kenmerken
GuidAttribute InterfaceTypeAttribute

Voorbeelden

monString = "service:mexAddress=http://localhost:8000/ServiceModelSamples/Service?wsdl"  
    monString = monString + ", address=http://localhost:8000/ServiceModelSamples/Service"  
    monString = monString + ", binding=BasicHttpBinding_ICalculator, bindingNamespace=http://Microsoft.ServiceModel.Samples"  
    monString = monString + ", contract=ICalculator, contractNamespace=http://Microsoft.ServiceModel.Samples"  

    Set monikerProxy = GetObject(monString)  

    'Set the Service Certificate.  
    monikerProxy.ChannelCredentials.SetServiceCertificateAuthentication "CurrentUser", "NoCheck", "PeerOrChainTrust"  
    monikerProxy.ChannelCredentials.SetDefaultServiceCertificateFromStore "CurrentUser", "TrustedPeople", "FindBySubjectName", "localhost"  

    'Set the Client Certificate.  
    monikerProxy.ChannelCredentials.SetClientCertificateFromStoreByName "CN=client.com", "CurrentUser", "My"  
    MsgBox monikerProxy.Add(3, 4)

Opmerkingen

Niet-beheerde clients gebruiken de 'service'-moniker voor toegang tot Windows Communication Foundation (WCF)-services. Deze clients zijn onderworpen aan het WCF-beveiligingsmodel in plaats van het COM-beveiligingsmodel. De IChannelCredentials interface wordt verstrekt om kanaalreferenties op te geven. Dit is vereist omdat de COM-moniker geen toegang heeft tot het beheerde WCF-beveiligingsobjectmodel.

Het is niet wettelijk om methoden aan te roepen op de IChannelCredentials interface nadat het kanaal is gemaakt. Dit komt doordat Windows Communication Foundation (WCF) geen ondersteuning biedt voor het wijzigen van beveiligingsinstellingen op een al geopend kanaal. Wanneer de service moniker-client een proxy verkrijgt, wordt het kanaal nog niet gemaakt. De client moet dus methoden aanroepen IChannelCredentials voordat de servicemethode wordt aangeroepen. Als de client een IChannelCredentials methode aanroept nadat de servicemethode is aangeroepen, wordt de uitzondering RPC_E_TOO_LATE gegenereerd.

Methoden

Name Description
SetClientCertificateFromFile(String, String, String)

Haalt een certificaat op uit een bestand en voegt dit toe aan de clientreferenties.
SetClientCertificateFromStore(String, String, String, Object)

Hiermee haalt u een certificaat op uit een certificaatarchief en voegt u het toe aan de clientreferenties.
SetClientCertificateFromStoreByName(String, String, String)

Hiermee wordt een certificaat opgehaald uit een certificaatarchief op naam en toegevoegd aan de clientreferenties.
SetDefaultServiceCertificateFromFile(String, String, String)

Hiermee haalt u een certificaat op uit een bestand en voegt u dit toe aan de servicereferenties als het standaardcertificaat.
SetDefaultServiceCertificateFromStore(String, String, String, Object)

Hiermee haalt u een certificaat op uit een certificaatarchief en voegt u dit toe aan de servicereferenties als het standaardcertificaat.
SetDefaultServiceCertificateFromStoreByName(String, String, String)

Hiermee wordt een certificaat opgehaald uit een certificaatarchief op naam en toegevoegd aan de servicereferenties als het standaardcertificaat.
SetIssuedToken(String, String, String)

Hiermee stelt u parameters in voor het uitgegeven token.
SetServiceCertificateAuthentication(String, String, String)

Hiermee stelt u de verificatieparameters voor servicecertificaten in.
SetUserNameCredential(String, String)

Hiermee stelt u de referenties van de gebruikersnaam in.
SetWindowsCredential(String, String, String, Int32, Boolean)

Hiermee stelt u de Windows-referenties in.

Van toepassing op