Método ISCardCmd::get_AlternateClassId

[El método get_AlternateClassId está disponible para su uso en los sistemas operativos especificados en la sección Requisitos. No está disponible para su uso en Windows Server 2003 con Service Pack 1 (SP1) y versiones posteriores, Windows Vista, Windows Server 2008 y versiones posteriores del sistema operativo. Los módulos de tarjeta inteligente proporcionan una funcionalidad similar.]

El método get_AlternateClassId recupera el valor del identificador de clase alternativo. Este método producirá un error a menos que una llamada anterior haya establecido el identificador alternativo en put_AlternateClassId.

Sintaxis

HRESULT get_AlternateClassId(
  [out] BYTE *pbyClass
);

Parámetros

pbyClass [out]

Puntero al byte que contiene el valor de identificador de clase alternativo en la devolución.

Valor devuelto

El método devuelve los siguientes valores posibles.

Código devuelto	Descripción
S_OK	La operación se completó correctamente.
E_INVALIDARG	El parámetro pbyClass no es válido.
E_ACCESSDENIED	La llamada a put_AlternateClassId no ha establecido previamente el identificador de clase alternativo.

 

Comentarios

Este método se aplica a las comunicaciones mediante el protocolo T=0. Para obtener más información, consulte put_AlternateClassId.

Ejemplos

En el ejemplo siguiente se muestra cómo recuperar el identificador de clase alternativo. En el ejemplo se supone que pISCardCmd es un puntero válido a una instancia de la interfaz ISCardCmd .

BYTE     byAltClassID;
HRESULT  hr;

// Retrieve the alternate class ID.
hr = pISCardCmd->get_AlternateClassId(&byAltClassID);
if (FAILED(hr))
{
  printf("Failed get_AltClassId\n");
  // Take other error handling action as needed.
}

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Fin de compatibilidad de cliente	Windows XP
Fin de compatibilidad de servidor	Windows Server 2003
Encabezado	Scarddat.h
Biblioteca de tipos	Scarddat.tlb
Archivo DLL	Scardssp.dll
IID	IID_ISCardCmd se define como D5778AE3-43DE-11D0-9171-00AA00C18068

Consulte también

ISCardCmd

put_AlternateClassId