Metodo ICredentialProviderCredential::GetStringValue (credentialprovider.h)

Abilita il recupero del testo da una credenziale con un campo di testo.

Sintassi

HRESULT GetStringValue(
  [in]  DWORD  dwFieldID,
  [out] LPWSTR *ppsz
);

Parametri

[in] dwFieldID

Tipo: DWORD

Identificatore del campo.

[out] ppsz

Tipo: LPWSTR*

Puntatore alla memoria contenente una stringa Unicode con terminazione Null per tornare all'interfaccia utente di accesso o all'interfaccia utente delle credenziali.

Valore restituito

Tipo: HRESULT

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

È facoltativo.

L'interfaccia utente di accesso e l'interfaccia utente delle credenziali usa questo metodo per ottenere pszLabel per un campo. Queste informazioni sono necessarie per ottenere valori per i campi CPFT_LARGE_TEXT, CPFT_SMALL_TEXT, CPFT_COMMAND_LINK, CPFT_EDIT_TEXT e CPFT_PASSWORD_TEXT .

Procedure consigliate per il provider di credenziali

I provider di credenziali gestiscono segreti utente estremamente sensibili per completare l'accesso e sbloccare le richieste. Come procedura consigliata, le informazioni segrete, ad esempio password e PIN, devono essere gestite con la massima attenzione. Le tecniche appropriate per la gestione delle informazioni segrete all'interno di un provider di credenziali sono:

• Rimuovere sempre in modo sicuro i segreti. A tale scopo, chiama SecureZeroMemory prima di liberare la memoria usata per contenere qualsiasi segreto.
• Eliminare in modo sicuro i segreti immediatamente dopo l'uso.
• Eliminare in modo sicuro i segreti se non vengono usati per lo scopo previsto entro un periodo di tempo previsto.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	credentialprovider.h