SCardGetReaderIconW 関数 (winscard.h)

SCardGetReaderIcon 関数は、特定のリーダー名のスマート カード リーダーのアイコンを取得します。 この関数は、カード リーダーの状態には影響しません。

構文

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

パラメーター

[in] hContext

クエリのリソース マネージャー コンテキストを識別するハンドル。 SCardEstablishContext 関数を前回呼び出すことで、リソース マネージャー コンテキストを設定できます。 このパラメーターは NULLできません。

[in] szReaderName

閲覧者名。 この値を取得するには、SCardListReaders 関数を呼び出します。

[out] pbIcon

アイコン ファイルから読み取られたスマート カード リーダー アイコンの BLOB を含むバッファーへのポインター。 この値が NULL場合、この関数は、pcbIcon パラメーターで指定されたバッファー長を無視し、このパラメーターが NULL でなかった場合に pcbIcon に返されたバッファーの長さを書き込み、成功コードを返します。

[in, out] pcbIcon

pbIcon バッファーの長さ (文字数)。 このパラメーターは、受信した属性の実際の長さを受け取ります。 バッファーの長さがSCARD_AUTOALLOCATEとして指定されている場合、pbIcon ポインターからバイト ポインターに変換され、属性を含むメモリ ブロックのアドレスを受け取ります。 このメモリ ブロックは、SCardFreeMemory 関数で割り当てを解除する必要があります。

戻り値

この関数は、成功するか失敗したかに応じて異なる値を返します。

備考

アイコンは、アルファ チャネルのない 256 ピクセル× 256 ピクセルである必要があります。

例

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);
}

必要条件