ISCardCmd::p ut_AlternateClassId-Methode

[Die put_AlternateClassId-Methode steht für die Verwendung in den im Abschnitt Anforderungen angegebenen Betriebssystemen zur Verfügung. Es ist nicht für die Verwendung in Windows Server 2003 mit Service Pack 1 (SP1) und höher, Windows Vista, Windows Server 2008 und nachfolgenden Versionen des Betriebssystems verfügbar. Die Smartcardmodule bieten ähnliche Funktionen.]

Die put_AlternateClassId-Methode gibt einen neuen alternativen Klassenbezeichner in der Anwendungsprotokolldateneinheit (Application Protocol Data Unit , APDU) an.

Syntax

HRESULT put_AlternateClassId(
  [in] BYTE byClass
);

Parameter

byClass [in]

Alternativer Klassenbezeichner. Der Standardwert ist 0 (null).

Rückgabewert

Die -Methode gibt einen der folgenden möglichen Werte zurück.

Bemerkungen

Bei der Kommunikation über das T=0-Protokoll können zusätzliche Karte Befehle automatisch von der APDU generiert und an die Übertragungsprotokolldateneinheit (TPDU) gesendet werden. Die zusätzlichen Befehle verwenden in der Regel dieselbe Klassen-ID wie der ursprüngliche Befehl. Wenn Sie mithilfe dieser Methode eine neue Klassen-ID angeben, können automatisch generierte Befehle die neue Klassen-ID verwenden.

Beispiele

Das folgende Beispiel zeigt, wie Sie einen neuen alternativen Klassenbezeichner in der Anwendungsprotokolldateneinheit (Application Protocol Data Unit , APDU) festlegen. Im Beispiel wird davon ausgegangen, dass pISCardCmd ein gültiger Zeiger auf eine instance der ISCardCmd-Schnittstelle ist.

HRESULT  hr;

// Set the class ID.
hr = pISCardCmd->put_AlternateClassId(0xC0);
if (FAILED(hr))
{
  printf("Failed put_AlternateClassId\n");
  // Take other error handling action as needed.
}

Anforderungen

Siehe auch

ISCardCmd

get_AlternateClassId