ISCardISO7816::SelectFile-Methode

[Die SelectFile-Methode ist für die Verwendung in den 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 SelectFile-Methode erstellt einen APDU-Befehl ( Application Protocol Data Unit ), der eine aktuelle elementare Datei in einem logischen Kanal festlegt. Nachfolgende Befehle können implizit über den logischen Kanal auf die aktuelle Datei verweisen.

Wenn Sie ein Verzeichnis (DF) innerhalb des Karte Dateispeichers auswählen– bei dem es sich möglicherweise um den Stamm (MF) des Dateispeichers handeln kann, wird es zur aktuellen DF. Nach einer solchen Auswahl kann über diesen logischen Kanal auf eine implizite aktuelle Elementardatei verwiesen werden.

Wenn Sie eine elementare Datei auswählen, werden die ausgewählte Datei und ihr übergeordnetes Element als aktuelle Dateien festgelegt.

Nachdem die Antwort zurückgesetzt werden soll, wird der MF implizit über den logischen Basiskanal ausgewählt, es sei denn, dies wird in den Verlaufsbytes oder in der anfänglichen Datenzeichenfolge anders angegeben.

Syntax

HRESULT SelectFile(
  [in]      BYTE         byP1,
  [in]      BYTE         byP2,
  [in]      LPBYTEBUFFER pData,
  [in]      LONG         lBytesToRead,
  [in, out] LPSCARDCMD   *ppCmd
);

Parameter

byP1 [in]

Auswahlsteuerelement.

P1 (Oberes Byte in Wort): 8 7 6 5 4 3 2 1	Bedeutung
0000000xx	Datei-ID auswählen
00000000	EF, DF oder MF
00000001	Untergeordnete DF
00000010	EF unter DF
00000011	Übergeordnete DF der aktuellen DF

 

Bei P1=00 weiß der Karte entweder aufgrund einer bestimmten Codierung der Datei-ID oder aufgrund des Kontexts der Ausführung des Befehls, ob die auszuwählende Datei der MF, eine DF oder eine EF ist.

Wenn P1-P2=0000 eine Datei-ID angegeben wird, muss sie in den folgenden Umgebungen eindeutig sein:

• Direkte untergeordnete Elemente des aktuellen DF
• Übergeordnete DF
• Direkte untergeordnete Elemente des übergeordneten DF

Wenn P1-P2=0000 und das Datenfeld leer oder gleich 3F00 ist, wählen Sie den MF aus.

Bei P1=04 ist das Datenfeld ein DF-Name, möglicherweise richtig abgeschnitten.

Wenn diese Befehle unterstützt werden, werden bei aufeinander folgenden Befehlen mit demselben Datenfeld DFs ausgewählt, deren Namen mit dem Datenfeld übereinstimmen (d. a. beginnen Sie mit dem Befehlsdatenfeld). Wenn die Karte den Befehl mit einem leeren Datenfeld akzeptiert, können alle oder eine Teilmenge der DFs nacheinander ausgewählt werden.

byP2 [in]

Auswahlsteuerelement.

pData [in]

Daten für den Betrieb bei Bedarf; else, NULL. Zu den Datentypen, die in diesem Parameter übergeben werden, gehören:

• Datei-ID
• Pfad aus dem MF
• Pfad aus dem aktuellen DF
• DF-Name

lBytesToRead [in]

Leer (d. h. 0) oder maximale Datenlänge, die als Antwort erwartet wird.

ppCmd [in, out]

Bei der Eingabe ein Zeiger auf ein ISCardCmd-Schnittstellenobjekt oder NULL.

Bei der Rückgabe wird es mit dem APDU-Befehl gefüllt, der von diesem Vorgang erstellt wurde. Wenn ppCmd auf NULL festgelegt wurde, wird ein Smart KarteISCardCmd-Objekt intern erstellt und über den ppCmd-Zeiger zurückgegeben.

Rückgabewert

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

Bemerkungen

Sofern nicht anders angegeben, ändert die korrekte Ausführung des gekapselten Befehls die Sicherheits-status gemäß den folgenden Regeln:

• Wenn die aktuelle Elementardatei geändert wird oder keine aktuelle Elementardatei vorhanden ist, geht die sicherheitsspezifische status einer früheren aktuellen Elementardatei verloren.
• Wenn das aktuelle Filestore-Verzeichnis (DF) abstammt oder mit dem früheren aktuellen DF identisch ist, geht die sicherheitsspezifische status für den früheren aktuellen DF verloren. Die Sicherheit status allen gemeinsamen Vorgängern des vorherigen und neuen aktuellen DF beibehalten.

Eine Liste aller von dieser Schnittstelle bereitgestellten Methoden finden Sie unter ISCardISO7816.

Zusätzlich zu den oben aufgeführten COM-Fehlercodes gibt diese Schnittstelle möglicherweise einen Intelligenten Karte Fehlercode zurück, wenn eine Smart Karte-Funktion aufgerufen wurde, um die Anforderung abzuschließen. Weitere Informationen finden Sie unter Smartcard-Rückgabewerte.

Anforderungen

Siehe auch

ISCardISO7816