Partager via

Utilisation du cache d’informations d’identification

  • Article

Media Foundation fournit une implémentation par défaut de l’interface IMFNetCredentialCache . Une application qui implémente l’interface IMFNetCredentialManager peut utiliser l’objet de cache d’informations d’identification par défaut pour stocker les informations d’identification de l’utilisateur.

Pour créer l’objet de cache d’informations d’identification par défaut, appelez la fonction MFCreateCredentialCache .

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

Une fois le cache d’informations d’identification créé, l’application peut utiliser les méthodes suivantes pour obtenir un objet d’informations d’identification, définir les informations d’identification de l’utilisateur et spécifier les options de mise en cache.

  • Pour obtenir l’objet d’informations d’identification d’une URL, appelez IMFNetCredentialCache::GetCredential.

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

    Si les informations d’identification de l’URL spécifiée n’existent pas dans le cache des informations d’identification, GetCredential crée un objet d’informations d’identification avec des valeurs de nom d’utilisateur et de mot de passe vides.

  • Pour définir le nom d’utilisateur et le mot de passe sur l’objet d’informations d’identification, appelez IMFNetCredential::SetUser et IMFNetCredential::SetPassword.

  • Pour définir les options de mise en cache sur l’objet d’informations d’identification, appelez IMFNetCredentialCache::SetUserOptions.

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

    Les valeurs des paramètres dwOptionsFlags sont définies dans l’énumération MFNetCredentialOptions . Pour enregistrer les informations d’identification utilisateur d’une URL dans un stockage persistant, définissez l’indicateur MFNET_CREDENTIAL_SAVE. Si l’appel SetUserOptions se termine correctement, l’appel suivant à GetCredential recherche les informations d’identification dans le stockage persistant. Si une correspondance est trouvée, cette méthode retourne un pointeur vers l’objet d’informations d’identification qui contient les informations.

    Par défaut, les informations d’identification de l’utilisateur envoyées sur le réseau sont chiffrées. Pour modifier ce paramètre en texte clair, définissez l’indicateur MFNET_CREDENTIAL_ALLOW_CLEAR_TEXT.

    Pour supprimer des informations du Registre, appelez GetCredential pour obtenir l’objet d’informations d’identification, puis appelez SetUserOption et définissez dwOptionsFlags sur MFNET_CREDENTIAL_DONT_CACHE.

Authentification source réseau