DRMInitEnvironment, fonction (msdrm.h)
[Le SDK AD RMS tirant parti des fonctionnalités exposées par le client dans Msdrm.dll est disponible pour une utilisation dans Windows Server 2008, Windows Vista, Windows Server 2008 R2, Windows 7, Windows Server 2012 et Windows 8. Il sera peut-être modifié ou indisponible dans les versions ultérieures. Au lieu de cela, utilisez le KIT SDK Active Directory Rights Management Services 2.1, qui tire parti des fonctionnalités exposées par le client dans Msipc.dll.]
La fonction DRMInitEnvironment crée un environnement sécurisé pour tous les appels de gestion des droits.
Syntaxe
DRMEXPORT HRESULT UDAPICALL DRMInitEnvironment(
[in] DRMSECURITYPROVIDERTYPE eSecurityProviderType,
[in] DRMSPECTYPE eSpecification,
[in] PWSTR wszSecurityProvider,
[in] PWSTR wszManifestCredentials,
[in] PWSTR wszMachineCredentials,
[out] DRMENVHANDLE *phEnv,
[out] DRMHANDLE *phDefaultLibrary
);
Paramètres
[in] eSecurityProviderType
Spécifie le type de fournisseur de sécurité à utiliser.
[in] eSpecification
Spécifie le fournisseur de sécurité à utiliser.
[in] wszSecurityProvider
Nom de fichier et ID du fournisseur de sécurité. Un fournisseur de sécurité peut être un fichier sur l’ordinateur (la zone de verrouillage) ou un appareil matériel qui contient la clé d’ordinateur sécurisée. Le chemin d’accès à cette clé est obtenu en appelant DRMGetSecurityProvider.
[in] wszManifestCredentials
Structure XrML signée qui spécifie des conditions sur l’environnement. Pour plus d’informations sur la création d’un manifeste, consultez Création d’un manifeste d’application.
[in] wszMachineCredentials
Certificat de l’ordinateur.
[out] phEnv
Pointeur vers un handle d’environnement. Fermez le handle en appelant DRMCloseEnvironmentHandle.
[out] phDefaultLibrary
Pointeur vers le handle de la bibliothèque utilisée pour créer l’objet principal. Vous devez fermer ce handle avant de fermer le handle d’environnement. Pour plus d'informations, consultez la section Notes. Fermez-vous en appelant DRMCloseHandle.
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, mais ne sont pas limitées à celles figurant dans la liste suivante. Pour obtenir la liste des codes d’erreur courants, consultez Valeurs HRESULT courantes.
Remarques
Cette fonction charge la zone de verrouillage et s’assure que seules les DLL légales sont chargées, selon le manifeste.
L’ordre des certificats est d’abord le moins approuvé au plus approuvé (le plus proche de la racine) en dernier.
Lors de la fermeture des handles retournés par cette fonction, fermez le handle de bibliothèque avant de fermer le handle d’environnement. Sinon, vous recevrez une erreur E_DRM_ENV_NOT_LOADED . Fermez le handle de bibliothèque en appelant DRMCloseHandle. Fermez le handle d’environnement en appelant DRMCloseEnvironmentHandle.
Configuration requise
| Plateforme cible | Windows |
| En-tête | msdrm.h |
| Bibliothèque | Msdrm.lib |
| DLL | Msdrm.dll |