Freigeben über


SCardSetAttrib-Funktion (winscard.h)

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