Metodo ISCardVerify::ChangeCode
[Il metodo ChangeCode è 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 ChangeCode sostituisce il codice CHV corrente (verifica del titolare della carta) con il nuovo codice CHV.
Sintassi
HRESULT ChangeCode(
[in] LPBYTEBUFFER pOldCode,
[in] LPBYTEBUFFER pNewCode,
[in] SCARD_FLAGS Flags,
[in] LONG lRef
);
Parametri
-
pOldCode [in]
-
Puntatore a un IByteBuffer contenente il codice corrente dell'utente.
-
pNewCode [in]
-
Puntatore a un IByteBuffer contenente il nuovo codice che verrà presentato alla smart card durante il processo di modifica per autenticare l'utente.
-
Flag [in]
-
Indica se il codice è globale o locale e se il codice deve essere abilitato o disabilitato.
-
SC_FL_IHV_GLOBAL
-
SC_FL_IHV_LOCAL
-
SC_FL_IHV_ENABLE
-
SC_FL_IHV_DISABLE
-
-
lRef [in]
-
Riferimento specifico della smart card.
Valore restituito
Il metodo restituisce uno dei valori possibili seguenti:
| Codice restituito | Descrizione |
|---|---|
|
Operazione completata correttamente. |
|
Parametro non valido. |
|
È stato passato un puntatore non valido. |
|
Memoria insufficiente. |
Commenti
Per un elenco di tutti i metodi definiti da questa interfaccia, vedere ISCardVerify.
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 della smart card.
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 |
Vedi anche