X509CertificateStore.FindCertificateBySubjectString Method

Article
09/15/2006

Finds an X509Certificate in the store using the certificate's name value. This search uses substring matching.

Namespace: Microsoft.Web.Services2.Security.X509
Assembly: Microsoft.Web.Services2 (in microsoft.web.services2.dll)

Usage

'Usage
Dim subjectsubstring As String
Dim returnValue As X509CertificateCollection
Dim x509CertificateStore1 As X509CertificateStore
returnValue = x509CertificateStore1.FindCertificateBySubjectString(subjectsubstring)

Syntax

'Declaration
Public Function FindCertificateBySubjectString( _
    ByVal subjectsubstring As String _
) As X509CertificateCollection

public X509CertificateCollection FindCertificateBySubjectString(
    string subjectsubstring
);

public: X509CertificateCollection^ FindCertificateBySubjectString(
    String^ subjectsubstring
);

public X509CertificateCollection FindCertificateBySubjectString(
    System.String subjectsubstring
);

public function FindCertificateBySubjectString(
     subjectsubstring : String
) : X509CertificateCollection;

Parameters

subjectsubstring
A string that contains part of the certificate's name value.

Return Value

A X509CertificateCollection that contains the search result.

Exceptions

Exception type	Condition
System.InvalidOperationException	The store is not yet opened.

Thread Safety

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Platforms

Development Platforms

Windows XP Home Edition, Windows XP Professional, Windows Server 2003, Windows Longhorn, and Windows 2000

Target Platforms

Windows 2000, Windows 2000 Server, Windows 2000 Advanced Server, Windows XP Home Edition, Windows XP Professional, Windows Server 2003, Windows Longhorn, Pocket PC, Windows CE, Smart Phone