Função SCardSetAttrib (winscard.h)

A função SCardSetAttrib define o atributo de leitor fornecido para o identificador fornecido. Isso não afeta o estado do leitor, do driver do leitor ou do cartão inteligente. Nem todos os atributos têm suporte de todos os leitores (nem podem ser definidos em todos os momentos), pois muitos dos atributos estão sob controle direto do protocolo de transporte.

Sintaxe

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

Parâmetros

[in] hCard

Valor de referência retornado de SCardConnect.

[in] dwAttrId

Identificador do atributo a ser definido. Os valores são somente gravação. Observe que os fornecedores podem não dar suporte a todos os atributos.

[in] pbAttr

Ponteiro para um buffer que fornece o atributo cuja ID é fornecida em dwAttrId.

[in] cbAttrLen

Comprimento (em bytes) do valor do atributo no buffer pbAttr .

Retornar valor

Essa função retorna valores diferentes dependendo se ela é bem-sucedida ou falha.

Comentários

A função SCardSetAttrib é uma função de acesso direto cartão. Para obter informações sobre outras funções de acesso direto, consulte Funções de acesso a cartão direto.

Exemplos

O exemplo a seguir mostra como definir um atributo.

// 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");

Requisitos

Confira também

Scardconnect

SCardGetAttrib