Fonction CoQueryClientBlanket (combaseapi.h)
Appelé par le serveur pour en savoir plus sur le client qui a appelé la méthode s’exécutant sur le thread actif. Il s’agit d’une fonction d’assistance pour IServerSecurity::QueryBlanket.
Syntaxe
HRESULT CoQueryClientBlanket(
[out, optional] DWORD *pAuthnSvc,
[out, optional] DWORD *pAuthzSvc,
[out, optional] LPOLESTR *pServerPrincName,
[out, optional] DWORD *pAuthnLevel,
[out, optional] DWORD *pImpLevel,
[out, optional] RPC_AUTHZ_HANDLE *pPrivs,
[in, out, optional] DWORD *pCapabilities
);
Paramètres
[out, optional] pAuthnSvc
Pointeur vers une variable qui reçoit le service d’authentification actuel. Il s’agit d’une valeur unique extraite des constantes du service d’authentification. Si l’appelant spécifie NULL, le service d’authentification actuel n’est pas récupéré.
[out, optional] pAuthzSvc
Pointeur vers une variable qui reçoit le service d’autorisation actuel. Il s’agit d’une valeur unique extraite des constantes d’autorisation. Si l’appelant spécifie NULL, le service d’autorisation actuel n’est pas récupéré.
[out, optional] pServerPrincName
Nom du principal actuel. La chaîne est allouée par l’appelé à l’aide de CoTaskMemAlloc et doit être libérée par l’appelant à l’aide de CoTaskMemFree. Par défaut, les noms de principaux Schannel sont au format msstd. Le formulaire complet est retourné si EOAC_MAKE_FULLSIC est spécifié dans le paramètre pCapabilities . Pour plus d’informations sur les formulaires msstd et fullsic, consultez Noms principaux. Si l’appelant spécifie NULL, le nom du principal actuel n’est pas récupéré.
[out, optional] pAuthnLevel
Pointeur vers une variable qui reçoit le niveau d’authentification actuel. Il s’agit d’une valeur unique extraite des constantes de niveau d’authentification. Si l’appelant spécifie NULL, le niveau d’authentification actuel n’est pas récupéré.
[out, optional] pImpLevel
Ce paramètre doit avoir la valeur NULL.
[out, optional] pPrivs
Pointeur vers un handle qui reçoit les informations de privilège pour l’application cliente. Le format de la structure à laquelle le handle fait référence dépend du service d’authentification. L’application ne doit pas écrire ou libérer la mémoire. Les informations sont valides uniquement pendant la durée de l’appel en cours. Pour NTLMSSP et Kerberos, il s’agit d’une chaîne identifiant le principal du client. Pour Schannel, il s’agit d’une structure CERT_CONTEXT qui représente le certificat du client. Si le client n’a pas de certificat, null est retourné. Si l’appelant spécifie NULL, les informations de privilège actuelles ne sont pas récupérées. Voir RPC_AUTHZ_HANDLE.
[in, out, optional] pCapabilities
Pointeur pour retourner des indicateurs indiquant les fonctionnalités de l’appel. Pour demander que le nom principal soit retourné sous forme complète si Schannel est le service d’authentification, l’appelant peut définir l’indicateur EOAC_MAKE_FULLSIC dans ce paramètre. Si l’appelant spécifie NULL, les fonctionnalités actuelles ne sont pas récupérées.
Valeur retournée
Cette fonction peut retourner les valeurs de retour standard E_INVALIDARG, E_OUTOFMEMORY et S_OK.
Notes
CoQueryClientBlanket est appelé par le serveur pour obtenir des informations de sécurité sur le client qui a appelé la méthode s’exécutant sur le thread actif. Cette fonction encapsule la séquence suivante d’appels courants (gestion des erreurs exclue) :
CoGetCallContext(IID_IServerSecurity, (void**)&pss);
pss->QueryBlanket(pAuthnSvc, pAuthzSvc, pServerPrincName,
pAuthnLevel, pImpLevel, pPrivs, pCapabilities);
pss->Release();
Cette séquence appelle CoGetCallContext pour obtenir un pointeur vers IServerSecurity et, avec le pointeur résultant, appelle IServerSecurity::QueryBlanket , puis libère le pointeur.
Spécifications
| 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 |