SCardGetReaderIconA 函式 （winscard.h）

SCardGetReaderIcon 函式會取得指定讀取器名稱的智慧卡讀取器圖示。 此函式不會影響卡片讀取器的狀態。

語法

LONG SCardGetReaderIconA(
  [in]      SCARDCONTEXT hContext,
  [in]      LPCSTR       szReaderName,
  [out]     LPBYTE       pbIcon,
  [in, out] LPDWORD      pcbIcon
);

參數

[in] hContext

識別查詢之資源管理員內容的句柄。 您可以透過先前呼叫 SCardEstablishContext 函式來設定資源管理員內容。 這個參數不能 NULL。

[in] szReaderName

讀取器名稱。 您可以呼叫 SCardListReaders 函式來取得此值。

[out] pbIcon

緩衝區的指標，其中包含從圖示檔讀取的智慧卡讀取器圖示 BLOB。 如果此值 NULL，則函式會忽略 參數中提供的緩衝區長度，如果此參數不是 NULL，則會寫入傳回給 的緩衝區長度，並傳回成功碼。

[in, out] pcbIcon

pbIcon 緩衝區的長度，以字元為單位。 此參數會接收所接收屬性的實際長度。 如果緩衝區長度指定為SCARD_AUTOALLOCATE，則 pbIcon 會從指標轉換成位元組指標，並接收包含 屬性的記憶體區塊位址。 此記憶體區塊必須與 SCardFreeMemory 函式解除分配。

傳回值

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

言論

圖示應該是 256 × 256 像素，沒有 Alpha 色板。

例子

PBYTE    pbIcon = NULL;
DWORD    cbIcon = SCARD_AUTOALLOCATE;
DWORD    i;
LONG     lReturn;
LPTSTR   szReaderName = "USB Smart Card Reader 0";

// Retrieve the reader's icon.
// hContext was set by a previous call to SCardEstablishContext.
lReturn = SCardGetReaderIcon(hContext,
                         szReaderName,
                         (PBYTE)&pbIcon,
                         &cbIcon);

if ( SCARD_S_SUCCESS != lReturn )
{
    printf("Failed SCardGetReaderIcon - %x\n", lReturn);
    // Take appropriate action.
}
else
{
    // Free the memory when done. 
    lReturn = SCardFreeMemory(hContext, pbIcon);
}

要求