Función SCardGetDeviceTypeIdA (winscard.h)

La función SCardGetDeviceTypeId obtiene el identificador de tipo de dispositivo del lector de tarjetas para el nombre de lector especificado. Esta función no afecta al estado del lector.

Sintaxis

LONG SCardGetDeviceTypeIdA(
  [in]      SCARDCONTEXT hContext,
  [in]      LPCSTR       szReaderName,
  [in, out] LPDWORD      pdwDeviceTypeId
);

Parámetros

[in] hContext

Identificador que identifica el contexto del administrador de recursos para la consulta. Puede establecer el contexto del administrador de recursos llamando a la función SCardEstablishContext . Este parámetro no puede ser NULL.

[in] szReaderName

Nombre del lector. Para obtener este valor, llame a la función SCardListReaders .

[in, out] pdwDeviceTypeId

Identificador de tipo de dispositivo real. La lista de tipos de lector devueltos por esta función se muestra en el miembro ReaderType de la estructura SCARD_READER_CAPABILITIES .

Valor devuelto

Esta función devuelve valores diferentes en función de si se realiza correctamente o no.

Código devuelto	Descripción
Success	SCARD_S_SUCCESS.
Error	Código de error. Para obtener más información, consulte Valores devueltos de tarjeta inteligente.

Comentarios

Nota

El encabezado winscard.h define SCardGetDeviceTypeId como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 8 [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2012 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	winscard.h
Archivo DLL	Winscard.dll