Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
[Die get_AlternateClassId-Methode ist für die Verwendung in den im Abschnitt Anforderungen angegebenen Betriebssystemen verfügbar. 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 get_AlternateClassId-Methode ruft den Wert der alternativen Klassen-ID ab. Diese Methode schlägt fehl, es sei denn, die alternative ID wurde durch einen vorherigen Aufruf von put_AlternateClassId festgelegt.
Syntax
HRESULT get_AlternateClassId(
[out] BYTE *pbyClass
);
Parameter
-
pbyClass [out]
-
Zeiger auf das Byte, das bei der Rückgabe den wert der alternativen Klassen-ID enthält.
Rückgabewert
Die -Methode gibt die folgenden möglichen Werte zurück.
| Rückgabecode | Beschreibung |
|---|---|
|
Der Vorgang wurde erfolgreich abgeschlossen. |
|
Der pbyClass-Parameter ist ungültig. |
|
Die alternative Klassen-ID wurde zuvor nicht durch einen Aufruf von put_AlternateClassId festgelegt. |
Bemerkungen
Diese Methode gilt für die Kommunikation mit dem T=0-Protokoll. Weitere Informationen finden Sie unter put_AlternateClassId.
Beispiele
Das folgende Beispiel zeigt, wie Die alternative Klassen-ID abgerufen wird. Im Beispiel wird davon ausgegangen, dass pISCardCmd ein gültiger Zeiger auf eine instance der ISCardCmd-Schnittstelle ist.
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.
}
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows XP [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Windows Server 2003 [nur Desktop-Apps] |
| Ende des Supports (Client) |
Windows XP |
| Ende des Supports (Server) |
Windows Server 2003 |
| Header |
|
| Typbibliothek |
|
| DLL |
|
| IID |
IID_ISCardCmd ist definiert als D5778AE3-43DE-11D0-9171-00AA00C18068 |
Siehe auch