IWRdsProtocolConnection2 ::GetSerializedUserCredential, méthode (wtsprotocol.h)

Retourne des informations d’identification utilisateur sérialisées.

Syntaxe

HRESULT GetSerializedUserCredential(
    [out] WRDS_SERIALIZED_USER_CREDENTIAL** userCredential);

Syntaxe

HRESULT GetSerializedUserCredential(
  [out] WRDS_SERIALIZED_USER_CREDENTIAL **userCredential
);

Paramètres

[out] userCredential

Reçoit un pointeur vers une instance de WTS_SERIALIZED_USER_CREDENTIAL contenant les informations d’identification sérialisées si la fonction réussit. Pour libérer la mémoire allouée, le service Services Bureau à distance appelle la fonction WTSFreeMemoryEx et passe WTSTypeSerializedUserCredential pour le paramètre WTSTypeClass . Les implémentations de protocole peuvent transférer la propriété des informations d’identification obtenues à l’aide de WTSCloudAuthConvertAssertionToSerializedUserCredential (recommandé) après quoi elles ne doivent plus utiliser les informations d’identification. Les implémentations de protocole peuvent également utiliser WTSCloudAuthDuplicateSerializedUserCredential* pour dupliquer les informations d’identification sérialisées obtenues à partir de WTSCloudAuthConvertAssertionToSerializedUserCredential.

Valeur retournée

Si la fonction réussit, la fonction retourne S_OK. Si la fonction échoue, elle retourne une valeur HRESULT qui indique l’erreur. Pour obtenir la liste des codes d’erreur courants, consultez Valeurs HRESULT courantes.

Remarques

Si votre protocole retourne un code d’erreur HRESULT dans cette méthode et dans **IWRdsProtocolConnection ::GetUserCredentials, WinLogon affiche un écran d’ouverture de session pour demander des informations d’identification. Si votre protocole retourne S_OK, les informations d’identification sont transmises à WinLogon pour se connecter à l’utilisateur.

Spécifications