Funzione SCardGetCardTypeProviderNameW (winscard.h)

La funzione SCardGetCardTypeProviderName restituisce il nome del modulo (libreria di collegamento dinamico) che contiene il provider per un determinato nome di scheda e tipo di provider.

Sintassi

LONG SCardGetCardTypeProviderNameW(
  [in]      SCARDCONTEXT hContext,
  [in]      LPCWSTR      szCardName,
  [in]      DWORD        dwProviderId,
  [out]     WCHAR        *szProvider,
  [in, out] LPDWORD      pcchProvider
);

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 SCardGetCardTypeProviderName 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.

[out] szProvider

Variabile stringa per ricevere il nome del provider al completamento di questa funzione.

[in, out] pcchProvider

Puntatore al valore DWORD . All'input, pcchProvider fornisce la lunghezza del buffer szProvider in caratteri. Se questo valore è SCARD_AUTOALLOCATE, szProvider viene convertito in un puntatore a un puntatore a byte e riceve l'indirizzo di un blocco di memoria contenente la stringa. Questo blocco di memoria deve essere deallocato chiamando SCardFreeMemory.

Nell'output questo valore rappresenta il numero effettivo di caratteri, incluso il carattere di terminazione null , nella variabile szProvider.

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.

Al termine di questa funzione, il valore in szProvider può essere usato come terzo parametro in una chiamata a CryptAcquireContext.

Esempi

Nell'esempio seguente viene illustrato come recuperare il nome del provider per il contesto del lettore specificato. Nell'esempio si presuppone che hContext sia un handle valido ottenuto da una chiamata precedente alla funzione SCardEstablishContext.

LPTSTR szProvider = NULL;
LPTSTR szCardName = _T("WindowsCard");
DWORD  chProvider = SCARD_AUTOALLOCATE;
LONG   lReturn = SCARD_S_SUCCESS;

// Retrieve the provider name.
// hContext was set by SCardEstablishContext.
lReturn = SCardGetCardTypeProviderName(hContext,
                                       szCardName,
                                       SCARD_PROVIDER_CSP,
                                       (LPTSTR)&szProvider,
                                       &chProvider);
if (SCARD_S_SUCCESS == lReturn)
{
    BOOL fSts = TRUE;
    HCRYPTPROV hProv = NULL;
  
  // Acquire a Cryptographic operation context.
    fSts = CryptAcquireContext(&hProv,
                               NULL,
                               szProvider,
                               PROV_RSA_FULL,
                               0);
    // Perform Cryptographic operations with smart card
    // ...

    // Free memory allocated by SCardGetCardTypeProviderName.
    lReturn = SCardFreeMemory(hContext, szProvider);
}

Fabbisogno

Vedere anche

SCardEstablishContext

SCardFreeMemory

SCardSetCardTypeProviderName