ISCardISO7816::UpdateBinary-Methode
[Die UpdateBinary-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 UpdateBinary-Methode erstellt einen APDU-Befehl ( Application Protocol Data Unit ), der die in einer Elementardatei vorhandenen Bits mit den im APDU-Befehl angegebenen Bits aktualisiert.
Syntax
HRESULT UpdateBinary(
[in] BYTE byP1,
[in] BYTE byP2,
[in] LPBYTEBUFFER pData,
[in, out] LPSCARDCMD *ppCmd
);
Parameter
-
byP1 [in]
-
Offset zum Schreibspeicherort (Update) in die Binärdatei vom Anfang der Binärdatei. Wenn b8=1 in P1, dann werden b7 und b6 von P1 auf Null (RFU-Bits) festgelegt, b5 bis b1 von P1 sind ein kurzer EF-Bezeichner und P2 der Offset des ersten Bytes, das in Dateneinheiten vom Anfang der Datei aktualisiert werden soll. Wenn b8=0 in P1, dann P1 || P2 ist der Offset des ersten Bytes, das in Dateneinheiten vom Anfang der Datei aktualisiert werden soll.
-
byP2 [in]
-
Offset zum Schreibspeicherort (Update) in die Binärdatei vom Anfang der Binärdatei. Wenn b8=1 in P1, dann werden b7 und b6 von P1 auf Null (RFU-Bits) festgelegt, b5 bis b1 von P1 sind ein kurzer EF-Bezeichner und P2 der Offset des ersten Bytes, das in Dateneinheiten vom Anfang der Datei aktualisiert werden soll. Wenn b8=0 in P1, dann P1 || P2 ist der Offset des ersten Bytes, das in Dateneinheiten vom Anfang der Datei aktualisiert werden soll.
-
pData [in]
-
Zeiger auf die Zeichenfolge der zu aktualisierenden Dateneinheiten.
-
ppCmd [in, out]
-
Bei der Eingabe ein Zeiger auf ein ISCardCmd-Schnittstellenobjekt oder NULL.
Bei der Rückgabe wird er mit dem APDU-Befehl gefüllt, der von diesem Vorgang erstellt wurde. Wenn ppCmd auf NULL festgelegt wurde, wird intern ein intelligentes KarteISCardCmd-Objekt erstellt und mithilfe des ppCmd-Zeigers zurückgegeben.
Rückgabewert
Die -Methode gibt einen der folgenden möglichen Werte zurück.
| Rückgabecode | BESCHREIBUNG |
|---|---|
|
Operation erfolgreich abgeschlossen. |
|
Ungültiger Parameter. |
|
Ein ungültiger Zeiger wurde übergeben. |
|
Nicht genügend Arbeitsspeicher. |
Bemerkungen
Der gekapselte Befehl kann nur ausgeführt werden, wenn der sicherheitsrelevante status des intelligenten Karte die Sicherheitsattribute der zu verarbeitenden Elementardatei erfüllt.
Wenn der Befehl einen gültigen kurzen elementaren Bezeichner enthält, wird die Datei als aktuelle Elementardatei festgelegt.
Elementardateien ohne transparente Struktur können nicht gelöscht werden. Der gekapselte Befehl bricht ab, wenn er auf eine Elementardatei ohne transparente Struktur angewendet wird.
Eine Liste aller Methoden, die von dieser Schnittstelle bereitgestellt werden, finden Sie unter ISCardISO7816.
Zusätzlich zu den oben aufgeführten COM-Fehlercodes gibt diese Schnittstelle möglicherweise einen Fehlercode für intelligente Karte zurück, wenn eine intelligente Karte-Funktion aufgerufen wurde, um die Anforderung abzuschließen. Weitere Informationen finden Sie unter Smartcard-Rückgabewerte.
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_ISCardISO7816 ist definiert als 53B6AA68-3F56-11D0-916B-00AA00C18068 |
Siehe auch