Condividi tramite


Metodo ISCardCmd::p ut_P1

[Il metodo put_P1 è disponibile per l'uso nei sistemi operativi specificati nella sezione Requisiti. Non è disponibile per l'uso in Windows Server 2003 con Service Pack 1 (SP1) e versioni successive, Windows Vista, Windows Server 2008 e versioni successive del sistema operativo. I moduli smart card offrono funzionalità simili.

Il metodo put_P1 imposta il primo byte (P1) dell'unità dati del protocollo applicazione (APDU).

Sintassi

HRESULT put_P1(
  [in] BYTE byP1
);

Parametri

byP1 [in]

Byte che è il campo P1.

Valore restituito

Il metodo restituisce uno dei valori possibili seguenti.

Codice restituito Descrizione
S_OK
Operazione completata correttamente.
E_INVALIDARG
Il parametro byP1 non è valido.
E_OUTOFMEMORY
Memoria insufficiente.

 

Commenti

Per impostare il valore P2 dell'APDU, chiamare get_P2.

Per recuperare i valori P1, P2 e P3 esistenti, chiamare rispettivamente get_P1, get_P2 o get_P3.

Per un elenco di tutti i metodi forniti da questa interfaccia, vedere ISCardCmd.

Oltre ai codici di errore COM elencati in precedenza, questa interfaccia può restituire un codice di errore della smart card se è stata chiamata una funzione smart card per completare la richiesta. Per altre informazioni, vedere Valori restituiti smart card.

Esempio

Nell'esempio seguente viene illustrato come impostare il primo parametro (P1) byte dell'unità dati del protocollo applicazione (APDU). L'esempio presuppone che pISCardCmd sia un puntatore valido a un'istanza dell'interfaccia ISCardCmd .

HRESULT  hr;

// Set the P1 byte.
hr = pISCardCmd->put_P1(0x06);
if (FAILED(hr))
{
  printf("Failed put_P1\n");
  // Take other error handling action as needed.
}

Requisiti

Requisito Valore
Client minimo supportato
Windows XP [solo app desktop]
Server minimo supportato
Windows Server 2003 [solo app desktop]
Fine del supporto client
Windows XP
Fine del supporto server
Windows Server 2003
Intestazione
Scarddat.h
Libreria dei tipi
Scarddat.tlb
DLL
Scardssp.dll
IID
IID_ISCardCmd è definito come D5778AE3-43DE-11D0-9171-00AA0C18068

Vedi anche

get_P1

get_P2

get_P3

ISCardCmd

put_P2