CoImpersonateClient, fonction (combaseapi.h)

  • Article

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

Dissimulation

IServerSecurity::ImpersonateClient

Emprunt d'identité

Emprunt d’identité et appels asynchrones

Sécurité dans COM