ISCardCmd::get _ ApduLength-Methode
[Die _ get ApduLength-Methode ist für die Verwendung in den betriebssystemspezifischen Betriebssystemen verfügbar, die im Abschnitt Anforderungen angegeben sind. 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 _ ApduLength-Methode bestimmt die Länge der Anwendungsprotokolldateneinheit (Application Protocol Data Unit, APDU) in Bytes.
Syntax
HRESULT get_ApduLength(
[out] LONG *plSize
);
Parameter
-
plSize [ out]
-
Zeiger auf die Länge der APDU.
Rückgabewert
Die -Methode gibt einen der folgenden möglichen Werte zurück.
| Rückgabecode | Beschreibung |
|---|---|
|
Operation erfolgreich abgeschlossen. |
|
Der plSize-Parameter ist ungültig. |
|
Ein ungültiger Zeiger wurde in plSize übergeben. |
|
Nicht genügend Arbeitsspeicher. |
Bemerkungen
Rufen Sie get _ Apduauf, um die unformatierte Anwendungsprotokolldateneinheit (APDU) aus dem Bytepuffer abzurufen, der über einen IStream zugeordnet ist, der die APDU-Nachricht enthält.
Eine Liste aller von dieser Schnittstelle bereitgestellten Methoden finden Sie unter ISCardCmd.
Zusätzlich zu den oben aufgeführten COM-Fehlercodes gibt diese Schnittstelle möglicherweise einen Smartcardfehlercode zurück, wenn eine Smartcardfunktion aufgerufen wurde, um die Anforderung abzuschließen. Weitere Informationen finden Sie unter Smartcard-Rückgabewerte.
Beispiele
Das folgende Beispiel zeigt, wie die Länge der Anwendungsprotokolldateneinheit (Application Protocol Data Unit, APDU) abgerufen wird. Im Beispiel wird davon ausgegangen, dass pISCardCmd ein gültiger Zeiger auf eine Instanz der ISCardCmd-Schnittstelle ist.
LONG lLen;
HRESULT hr;
// Retrieve the APDU length.
hr = pISCardCmd->get_ApduLength(&lLen);
if (FAILED(hr))
{
printf("Failed get_ApduLength\n");
// Take other error handling action.
}
else
printf("Length returned is %d\n", lLen);
Requirements (Anforderungen)
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows [Nur XP-Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Windows Nur Server [ 2003-Desktop-Apps] |
| Ende des Supports (Client) |
Windows XP |
| Ende des Supports (Server) |
Windows Server 2003 |
| Header |
|
| Typbibliothek |
|
| DLL |
|
| IID |
IID _ ISCardCmd ist als D5778AE3-43DE-11D0-9171-00AA00C18068 definiert. |