SCardGetReaderDeviceInstanceIdA 函式 （winscard.h）

SCardGetReaderDeviceInstanceId 函式會取得指定讀取器名稱之卡片讀取器的裝置實例標識碼。 此函式不會影響讀取器的狀態。

語法

LONG SCardGetReaderDeviceInstanceIdA(
  [in]            SCARDCONTEXT hContext,
  [in]            LPCSTR       szReaderName,
  [out, optional] LPSTR        szDeviceInstanceId,
  [in, out]       LPDWORD      pcchDeviceInstanceId
);

參數

[in] hContext

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

[in] szReaderName

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

[out, optional] szDeviceInstanceId

接收讀取器裝置實例標識碼的緩衝區。 如果此值 NULL，函式會忽略 cchDeviceInstanceId 參數中提供的緩衝區長度，如果此參數未 NULL，則會寫入 cchDeviceInstanceId中傳回的緩衝區長度，並傳回成功碼。

[in, out] pcchDeviceInstanceId

szDeviceInstanceId 緩衝區的長度，包括 NULL 終止符。 如果緩衝區長度指定為 SCARD_AUTOALLOCATE，則 szDeviceInstanceId 參數會轉換成位元組指標的指標，並接收包含實例標識符的記憶體區塊位址。此記憶體區塊必須與 SCardFreeMemory 函式 解除分配。

傳回值

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

言論

此函式不會重新導向。 在遠端桌面會話內失敗時，呼叫 SCardGetReaderDeviceInstanceId 函式，並出現SCARD_E_READER_UNAVAILABLE錯誤碼。

例子

LONG     lReturn;
LPTSTR   szReaderName = "USB Smart Card Reader 0";
WCHAR    szDeviceInstanceId[256];
DWORD    cchDeviceInstanceId = 256;

// Retrieve the reader's device instance ID.
// hContext was set by a previous call to SCardEstablishContext.
lReturn = SCardGetReaderDeviceInstanceId (hContext,
                         szReaderName,
                         szDeviceInstanceId,
                         &cchDeviceInstanceId);

if ( SCARD_S_SUCCESS != lReturn )
{
    printf("Failed SCardGetReaderDeviceInstanceId - %x\n", lReturn);
    // Take appropriate action.
}

要求