Share via


SCardSetCardTypeProviderName

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This function specifies the name of the DLL containing the provider for a given card name and provider type.

Syntax

LONG SCardSetCardTypeProviderName(
  SCARDCONTEXT hContext,
  LPCTSTR szCardName,
  DWORD dwProviderId,
  LPCTSTR szProvider 
);

Parameters

  • hContext
    [in] Supplies the handle that identifies the resource manager context. The resource manager context can be set by a previous call to SCardEstablishContext. This value can be NULL if the call to SCardSetCardTypeProviderName is not directed to a specific context.
  • szCardName
    [in] Supplies the name of the card type with which this provider name is associated.
  • dwProviderId
    [in] Supplies the identifier for the provider associated with this card type. The following table shows the possible values for dwProviderId.

    Value Action

    SCARD_PROVIDER_PRIMARY

    The function specifies the name of the primary smart card service provider as a GUID string.

    SCARD_PROVIDER_CSP

    The function specifies the name of the cryptographic service provider.

  • szProvider
    [in] String variable being assigned as the provider name, representing the cryptographic service provider (CSP).

Return Value

The following table shows the possible return values.

Value Description

SCARD_S_SUCCESS

Succeeds

An error value (see Smart Card Error Values for a list of all error values).

Fails

Remarks

This function sets the provider name, while SCardGetCardTypeProviderName can be used to retrieve the provider name.

Requirements

Header winscard.h
Library winscard.lib
Windows Embedded CE Windows CE 3.0 and later
Windows Mobile Windows Mobile Version 5.0 and later