SCardSetAttrib-Funktion (winscard.h)

Artikel
08/27/2023

Die SCardSetAttrib-Funktion legt das angegebene Leserattribut für das angegebene Handle fest. Dies wirkt sich nicht auf den Zustand des Lesers, des Readertreibers oder des intelligenten Karte aus. Nicht alle Attribute werden von allen Lesern unterstützt (und können auch nicht jederzeit festgelegt werden), da viele attribute unter direkter Kontrolle des Transportprotokolls stehen.

Syntax

LONG SCardSetAttrib(
  [in] SCARDHANDLE hCard,
  [in] DWORD       dwAttrId,
  [in] LPCBYTE     pbAttr,
  [in] DWORD       cbAttrLen
);

Parameter

[in] hCard

Verweiswert, der von SCardConnect zurückgegeben wird.

[in] dwAttrId

Bezeichner für das festzulegende Attribut. Die Werte sind schreibgeschützt. Beachten Sie, dass Anbieter möglicherweise nicht alle Attribute unterstützen.

Wert	Bedeutung
SCARD_ATTR_SUPRESS_T1_IFS_REQUEST	Unterdrücken des Sendens des T=1-IFSD-Pakets vom Leser an den Karte. (Kann verwendet werden, wenn die aktuell eingefügte Karte keine IFSD-Anforderung unterstützt.)

[in] pbAttr

Zeiger auf einen Puffer, der das Attribut angibt, dessen ID in dwAttrId angegeben wird.

[in] cbAttrLen

Länge (in Bytes) des Attributwerts im pbAttr-Puffer .

Rückgabewert

Diese Funktion gibt unterschiedliche Werte zurück, je nachdem, ob sie erfolgreich ist oder fehlschlägt.

Rückgabecode	BESCHREIBUNG
Erfolgreich	SCARD_S_SUCCESS.
Fehler	Ein Fehlercode. Weitere Informationen finden Sie unter Smartcard-Rückgabewerte.

Hinweise

Die SCardSetAttrib-Funktion ist eine direkte Karte-Zugriffsfunktion. Informationen zu anderen Funktionen für den direkten Zugriff finden Sie unter Funktionen für den direkten Kartenzugriff.

Beispiele

Im folgenden Beispiel wird gezeigt, wie ein Attribut festgelegt wird.

// Set the attribute.
// hCardHandle was set by a previous call to SCardConnect.
// dwAttrID is a DWORD value, specifying the attribute ID.
// pbAttr points to the buffer of the new value.
// cByte is the count of bytes in the buffer.
lReturn = SCardSetAttrib(hCardHandle,
                         dwAttrID,
                         (LPBYTE)pbAttr,
                         cByte);
if ( SCARD_S_SUCCESS != lReturn )
    printf("Failed SCardSetAttrib\n");

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	winscard.h
Bibliothek	Winscard.lib
DLL	Winscard.dll

Weitere Informationen

SCardConnect

SCardGetAttrib