Metodo ICredentialProvider::SetUsageScenario (credentialprovider.h)

  • Articolo

Definisce gli scenari per i quali il provider di credenziali è valido. Chiamato ogni volta che viene inizializzato il provider di credenziali.

Sintassi

HRESULT SetUsageScenario(
  [in] CREDENTIAL_PROVIDER_USAGE_SCENARIO cpus,
  [in] DWORD                              dwFlags
);

Parametri

[in] cpus

Tipo: CREDENTIAL_PROVIDER_USAGE_SCENARIO

Lo scenario in cui è stato creato il provider di credenziali. Questo è lo scenario di utilizzo che deve essere supportato. Per altre informazioni, vedere la sezione Osservazioni.

[in] dwFlags

Tipo: DWORD

Valore che influisce sul comportamento del provider di credenziali. Questo valore può essere una combinazione OR bit per bit di uno o più dei valori seguenti definiti in Wincred.h. Per altre informazioni, vedere CredUIPromptForWindowsCredentials .

CREDUIWIN_GENERIC (0x00000001)

0x00000001. Il chiamante richiede che il provider di credenziali restituisca il nome utente e la password in testo normale. Questo valore non può essere combinato con CREDUIWIN_SECURE_PROMPT.

CREDUIWIN_CHECKBOX (0x00000002)

0x00000002. La casella di controllo Salva viene visualizzata nella finestra di dialogo.

CREDUIWIN_AUTHPACKAGE_ONLY (0x00000010)

0x00000010. È necessario enumerare solo i provider di credenziali che supportano il pacchetto di autenticazione di input. Se i provider di credenziali non supportano il pacchetto di autenticazione di input, devono enumerare zero riquadri utente. Questo valore non può essere combinato con CREDUIWIN_IN_CRED_ONLY.

CREDUIWIN_IN_CRED_ONLY (0x00000020)

0x00000020. Se il provider può serializzare le credenziali, deve enumerare un riquadro per tale credenziale. Non è necessario enumerare altri riquadri. I provider di credenziali devono usare il CREDENTIAL_PROVIDER_CREDENTIAL_SERIALIZATION di input in ICredentialProvider::SetSerialization e dwFlags in ICredentialProvider::SetUsageScenario per determinare il numero di riquadri delle credenziali da enumerare. Questo valore non può essere combinato con CREDUIWIN_AUTHPACKAGE_ONLY.

CREDUIWIN_ENUMERATE_ADMINS (0x00000100)

0x00000100. I provider di credenziali devono enumerare solo gli amministratori. Questo valore è destinato solo a scopi di Controllo dell'account utente. È consigliabile che i chiamanti esterni non impostino questo flag.

CREDUIWIN_ENUMERATE_CURRENT_USER (0x00000200)

0x00000200. I provider di credenziali devono enumerare un riquadro per l'utente attualmente connesso.

CREDUIWIN_SECURE_PROMPT (0x00001000)

0x00001000. La finestra di dialogo credenziali deve essere visualizzata sul desktop protetto. Questo valore non può essere combinato con CREDUIWIN_GENERIC. Gli implementatori del provider di credenziali possono ignorare in modo sicuro questo flag.

CREDUIWIN_PACK_32_WOW (0x10000000)

0x10000000. I buffer passati al provider sono a 32 bit. Anche i buffer restituiti dal provider devono essere a 32 bit. Questo è necessario per WOW64.

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 e consente al provider di credenziali di indicare come verrà usato.

Questo metodo deve restituire E_NOTIMPL se la chiamata viene completata, ma lo scenario di utilizzo richiesto non è supportato. Questo metodo deve restituire S_OK se il metodo ha esito positivo e lo scenario di utilizzo è supportato.

Requisiti

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