Metodo ICredentialProvider::GetCredentialCount (credentialprovider.h)

Articolo
08/22/2023

Ottiene il numero di credenziali disponibili in questo provider di credenziali.

Sintassi

HRESULT GetCredentialCount(
  [out] DWORD *pdwCount,
  [out] DWORD *pdwDefault,
  [out] BOOL  *pbAutoLogonWithDefault
);

Parametri

[out] pdwCount

Tipo: DWORD*

Puntatore a un valore DWORD che riceve il conteggio delle credenziali.

[out] pdwDefault

Tipo: DWORD*

Puntatore a un valore DWORD che riceve l'indice delle credenziali da usare come valore predefinito. Se non è stato impostato alcun valore predefinito, questo valore deve essere impostato su CREDENTIAL_PROVIDER_NO_DEFAULT.

[out] pbAutoLogonWithDefault

Tipo: BOOL*

Puntatore a un valore BOOL che indica se le credenziali predefinite identificate da pdwDefault devono essere usate per un tentativo di accesso automatico. Un tentativo di accesso automatico indica che l'interfaccia utente di accesso o l'interfaccia utente delle credenziali chiamerà immediatamente GetSerialization nel riquadro predefinito del provider.

Valore restituito

Tipo: HRESULT

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

Commenti

Questo metodo è obbligatorio.

Quando un'interfaccia utente di accesso o un'interfaccia utente delle credenziali è pronta per l'interazione dell'utente, per impostazione predefinita viene selezionata una credenziale predefinita. Poiché ogni provider di credenziali fornisce una credenziale predefinita, le regole seguenti determinano se pdwDefault riceverà lo stato attivo o se le credenziali verranno registrate automaticamente.

Se è già stata specificata una credenziale predefinita, tale credenziale non deve essere usata per l'accesso automatico e il pdwDefault viene usato per l'accesso automatico, pdwDefault verrà usato come impostazione predefinita.
Se pdwDefault proviene dall'ultimo provider connesso e non esiste già un valore predefinito con accesso automatico, pdwDefault verrà usato come impostazione predefinita.
Se non è stato specificato alcun valore predefinito, pdwDefault verrà usato come impostazione predefinita.

Se il numero di credenziali valide cambia, il provider di credenziali deve chiamare CredentialsChanged nell'istanza ICredentialProviderEvents fornita in Consiglia.

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

Condividi tramite