SCardGetCardTypeProviderNameA 函式 (winscard.h)

  • 發行項

SCardGetCardTypeProviderName 函式會傳回模組的名稱 (動態連結庫) ，其中包含指定卡片名稱和提供者類型的提供者。

語法

LONG SCardGetCardTypeProviderNameA(
  [in]      SCARDCONTEXT hContext,
  [in]      LPCSTR       szCardName,
  [in]      DWORD        dwProviderId,
  [out]     CHAR         *szProvider,
  [in, out] LPDWORD      pcchProvider
);

參數

[in] hContext

識別 資源管理員內容的句柄。 資源管理員內容可由先前呼叫 SCardEstablishContext 來設定。 如果 SCardGetCardTypeProviderName 的呼叫未導向至特定內容，這個值可以是 NULL。

[in] szCardName

與此提供者名稱相關聯的卡片類型名稱。

[in] dwProviderId

與此卡片類型相關聯的提供者標識碼。

值 意義
SCARD_PROVIDER_PRIMARY
1
 函式會將 智慧卡的主要服務提供者 名稱擷取為 GUID 字串。
SCARD_PROVIDER_CSP
2
 函式會擷取 密碼編譯服務提供者的名稱。
SCARD_PROVIDER_KSP
3
 函式會擷取智慧卡 密鑰儲存提供者 的名稱， (KSP) 。
SCARD_PROVIDER_CARD_MODULE
0x80000001
 函式會擷取卡片模組的名稱。

[out] szProvider

字串變數，以在成功完成此函式時接收 提供者名稱 。

[in, out] pcchProvider

DWORD 值的指標。 在輸入時， pcchProvider 會以字元提供 szProvider 緩衝區的長度。 如果此值是SCARD_AUTOALLOCATE， 則 szProvider 會轉換成位元組指標的指標，並接收包含字串的記憶體區塊位址。 此記憶體區塊必須藉由呼叫 SCardFreeMemory 來解除分配。

在輸出時，此值代表 szProvider 變數中的實際字元數，包括 Null 終止符。

傳回值

此函式會根據它是否成功或失敗，傳回不同的值。

傳回碼 Description
「成功」
 SCARD_S_SUCCESS。
失敗
 錯誤碼。 如需詳細資訊，請參閱 智慧卡傳回值。

備註

此函式不會重新導向，但在遠端桌面會話內呼叫函式時，不會產生錯誤。 這隻表示結果會來自遠端電腦，而不是本機計算機。

成功完成此函式時， szProvider 中的值可作為 CryptAcquireContext 呼叫中的第三個參數。

範例

下列範例示範如何擷取指定讀取器內容的提供者名稱。 此範例假設 hContext 是從先前呼叫 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);
}

注意

winscard.h 標頭會根據 UNICODE 預處理器常數的定義，將 SCardGetCardTypeProviderName 定義為別名，自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱 函式原型的慣例。

規格需求

需求 值
最低支援的用戶端 Windows XP [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 [僅限傳統型應用程式]
目標平台 Windows
標頭 winscard.h
程式庫 Winscard.lib
Dll Winscard.dll

另請參閱

SCardEstablishContext

SCardFreeMemory

SCardSetCardTypeProviderName