DRMIsActivated, fonction (msdrm.h)

Article
02/29/2024

[Le Kit de développement logiciel (SDK) AD RMS tirant parti des fonctionnalités exposées par

le client dans Msdrm.dll est disponible dans Windows Server 2008, Windows Vista, Windows Server 2008 R2, Windows 7, Windows Server 2012 et Windows 8. Il peut être modifié ou

non disponible dans les versions suivantes. Utilisez plutôt active Directory Rights Management Services SDK 2.1,

qui tire parti des fonctionnalités exposées par le client dans Msipc.dll.]

La fonction DRMIsActivated indique si l’utilisateur ou l’ordinateur actuel est activé.

Syntaxe

DRMEXPORT HRESULT UDAPICALL DRMIsActivated(
  [in] DRMHSESSION      hClient,
  [in] UINT             uFlags,
  [in] DRM_ACTSERV_INFO *pActServInfo
);

Paramètres

[in] hClient

Handle d’une session cliente créée à l’aide de la fonction DRMCreateClientSession .

[in] uFlags

Valeur qui détermine si l’utilisateur ou l’ordinateur actuel est interrogé pour l’activation status. Il peut s’agir de l’une des valeurs suivantes.

DRM_ACTIVATE_MACHINE

La machine est interrogée pour l’activation status. L’ordinateur est considéré comme activé s’il existe une zone de verrouillage valide pour l’utilisateur connecté et un certificat d’ordinateur valide dans le magasin de certificats par utilisateur.

Dans le client Rights Management Services 1.0, l’ordinateur est considéré comme activé s’il existe une zone de verrouillage valide et un certificat d’ordinateur valide.

DRM_ACTIVATE_GROUPIDENTITY

L’utilisateur actuel est interrogé pour l’activation status.

L’utilisateur actuel est considéré comme activé si le magasin de certificats de l’utilisateur actuel a un certificat de compte de droits émis à l’ID de groupe spécifié.

[in] pActServInfo

Ce paramètre est réservé et doit être défini sur NULL.

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. Les valeurs possibles incluent, sans s’y limiter, celles de la liste suivante. Pour obtenir la liste des codes d’erreur courants, consultez Valeurs HRESULT courantes.

Remarques

Vous pouvez appeler DRMIsActivated pour déterminer l’état actuel de l’activation de l’ordinateur ou de l’utilisateur avant d’appeler toute fonction nécessitant une activation préalable. Si DRMIsActivated échoue, appelez DRMActivate.

Cette fonction utilise en interne les informations contenues dans la session cliente. Si l’ID d’utilisateur associé à la session cliente ne correspond pas à l’ID de l’utilisateur connecté, cette fonction échoue. Pour plus d’informations, consultez DRMCreateClientSession.