SCardSetCardTypeProviderName

This function specifies the name of the module (dynamic link library) containing the provider for a given card name and provider type.

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 Values

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

OS Versions: Windows CE 3.0 and later.
Header: Winscard.h.
Link Library: Winscard.lib.

 Last updated on Saturday, April 10, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.