Share via


SCardGetCardTypeProviderName (Windows Embedded CE 6.0)

1/6/2010

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

Syntax

LONG SCardGetCardTypeProviderName(
  SCARDCONTEXT hContext,
  LPCTSTR szCardName,
  DWORD dwProviderId,
  LPTSTR szProvider,
  LPDWORD pcchProvider 
);

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 SCardGetCardTypeProviderName 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 provided for dwProviderId.

    Value Description

    SCARD_PROVIDER_PRIMARY

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

    SCARD_PROVIDER_CSP

    The function retrieves the name of the cryptographic service provider.

  • szProvider
    [out] String variable that contains the retrieved provider name upon successful completion of this function.
  • pcchProvider
    [in, out] Pointer to DWORD value. On input, pcchProvider supplies the length of the szProvider buffer in characters. If this value is SCARD_AUTOALLOCATE, szProvider is converted to a pointer to a byte pointer and receives the address of a block of memory containing the string. This block of memory must be deallocated by calling SCardFreeMemory.

    On output, this value represents the actual number of characters, including the null terminator, in the szProvider variable.

Return Value

This function returns different values depending on whether it succeeds or fails. 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

Upon successful completion of this function, the value in szProvider can be used as the third parameter in a call to CryptAcquireContext.

Requirements

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

See Also

Reference

Smart Card Functions
CryptAcquireContext
SCardSetCardTypeProviderName