Funzione SCardSetCardTypeProviderNameA (winscard.h)

La funzione SCardSetCardTypeProviderName specifica il nome del modulo (libreria di collegamento dinamico) contenente il provider per un determinato nome di scheda e tipo di provider.

Sintassi

LONG SCardSetCardTypeProviderNameA(
  [in] SCARDCONTEXT hContext,
  [in] LPCSTR       szCardName,
  [in] DWORD        dwProviderId,
  [in] LPCSTR       szProvider
);

Parametri

[in] hContext

Handle che identifica il contesto di gestione risorse . Il contesto di Resource Manager può essere impostato da una chiamata precedente a SCardEstablishContext. Questo valore può essere null se la chiamata a SCardSetCardTypeProvider Name non viene indirizzata a un contesto specifico.

[in] szCardName

Nome del tipo di scheda a cui è associato il nome del provider .

[in] dwProviderId

Identificatore per il provider associato a questo tipo di scheda.

[in] szProvider

Stringa contenente il nome del provider che rappresenta il provider CSP.

Valore restituito

Questa funzione restituisce valori diversi a seconda che abbia esito positivo o negativo.

Osservazioni

Questa funzione non viene reindirizzata, ma la chiamata alla funzione quando all'interno di una sessione desktop remoto non verrà generato un errore. Significa solo che il risultato sarà dal computer remoto anziché dal computer locale.

Questa funzione imposta il nome del provider, mentre SCardGetCardTypeProviderName può essere usato per recuperare il nome del provider.

Esempi

Nell'esempio seguente viene illustrato come specificare il nome del provider del tipo di scheda.

LPTSTR            szNewProvName = _T("My Provider Name");
LPTSTR            szCardName = _T("WindowsCard");
LONG              lReturn = SCARD_S_SUCCESS;

// Set the card type provider name.
// hContext was set by SCardEstablishContext.
lReturn = SCardSetCardTypeProviderName(hContext,
                                      szCardName,
                                      SCARD_PROVIDER_CSP,
                                      szNewProvName);
if ( SCARD_S_SUCCESS != lReturn )
{
    printf("Failed SCardSetCardTypeProviderName - %x\n", lReturn);
    exit(1);
}

Fabbisogno

Vedere anche

SCardGetCardTypeProviderName