CoImpersonateClient, fonction (combaseapi.h)
Permet au serveur d’emprunter l’identité du client de l’appel actuel pendant la durée de l’appel.
Syntaxe
HRESULT CoImpersonateClient();
Valeur de retour
Cette fonction prend en charge les valeurs de retour standard, y compris les S_OK.
Remarques
Cette méthode permet au serveur d’emprunter l’identité du client de l’appel actuel pendant la durée de l’appel. Si vous n’appelez pas CoRevertToSelf, COM est automatiquement rétabli pour vous. Cette fonction échoue, sauf si l’objet est appelé avec une authentification RPC_C_AUTHN_LEVEL_CONNECT ou supérieure (qui est n’importe quel niveau d’authentification à l’exception de RPC_C_AUTHN_LEVEL_NONE). Cette fonction encapsule la séquence suivante d’appels courants (gestion des erreurs exclue) :
CoGetCallContext(IID_IServerSecurity, (void**)&pss);
pss->ImpersonateClient();
pss->Release();
CoImpersonateClient encapsule le processus d’obtention d’un pointeur vers un instance de IServerSecurity qui contient des données sur l’appel actuel, en appelant sa méthode ImpersonateClient, puis en libérant le pointeur. Un appel à CoRevertToSelf (ou IServerSecurity::RevertToSelf) annule n’importe quel nombre d’appels pour emprunter l’identité du client.
Configuration requise
| Client minimal pris en charge | Windows 2000 Professionnel [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows 2000 Server [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | combaseapi.h (inclure Objbase.h) |
| Bibliothèque | Ole32.lib |
| DLL | Ole32.dll |
Voir aussi
IServerSecurity::ImpersonateClient