Condividi tramite

Uso della cache delle credenziali

Media Foundation fornisce un'implementazione predefinita dell'interfacciaIMFNetCredentialCache. Un'applicazione che implementa l'interfacciaIMFNetCredentialManagerpuò usare l'oggetto cache delle credenziali predefinito per archiviare le credenziali dell'utente.

Per creare l'oggetto cache delle credenziali predefinito, chiamare la funzioneMFCreateCredentialCache.

HRESULT hr = S_OK;
IMFNetCredentialCache *pCredentialCache = NULL;
hr = MFCreateCredentialCache(&pCredentialCache);

Dopo aver creato la cache delle credenziali, l'applicazione può usare i metodi seguenti per ottenere un oggetto credenziale, impostare le credenziali utente e specificare le opzioni di memorizzazione nella cache.

  • Per ottenere l'oggetto delle credenziali associato a un URL, utilizzare IMFNetCredentialCache::GetCredential.

    hr = pCredentialCache-> GetCredential(
        pszUrl,
        pszRealm,
        dwAuthenticationFlags,
        &pCredential,
        &dwRequirementsFlags);

    Se le credenziali per l'URL specificato non esistono nella cache delle credenziali, GetCredential crea un nuovo oggetto credenziale con valori di nome utente e password vuoti.

  • Per impostare il nome utente e la password nell'oggetto credenziali, chiamare IMFNetCredential::SetUser e IMFNetCredential::SetPassword.

  • Per impostare le opzioni di memorizzazione nella cache nell'oggetto credenziali, chiamare IMFNetCredentialCache::SetUserOptions.

    hr = pCredentialCache-> SetUserOptions( 
        pCredentialCache,
        MFNET_CREDENTIAL_SAVE);

    I valori del parametro dwOptionsFlags sono definiti nell'enumerazione MFNetCredentialOptions. Per salvare le credenziali utente per un URL in un archivio permanente, impostare il flag MFNET_CREDENTIAL_SAVE. Se la chiamataSetUserOptionsviene completata correttamente, la chiamata successiva a GetCredential cerca le credenziali nella risorsa di archiviazione permanente. Se viene trovata una corrispondenza, questo metodo restituisce un puntatore all'oggetto credenziale che contiene le informazioni.

    Per impostazione predefinita, le credenziali utente inviate in rete vengono crittografate. Per modificare questa opzione in testo in chiaro, impostare il flag MFNET_CREDENTIAL_ALLOW_CLEAR_TEXT.

    Per rimuovere informazioni dal Registro di sistema, chiamare GetCredential per ottenere l'oggetto credenziale e quindi chiamare SetUserOption e impostare dwOptionsFlags su MFNET_CREDENTIAL_DONT_CACHE.

Autenticazione dell'origine di rete

 

 

  • Last updated on