Función DRMInitEnvironment (msdrm.h)

[El SDK de AD RMS que aprovecha la funcionalidad expuesta por el cliente en Msdrm.dll está disponible para su uso en Windows Server 2008, Windows Vista, Windows Server 2008 R2, Windows 7, Windows Server 2012 y Windows 8. En versiones posteriores podría modificarse o no estar disponible. En su lugar, use active Directory Rights Management Services SDK 2.1, que aprovecha la funcionalidad expuesta por el cliente en Msipc.dll.]

La función DRMInitEnvironment crea un entorno seguro para todas las llamadas de administración de derechos.

Sintaxis

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
);

Parámetros

[in] eSecurityProviderType

Especifica el tipo de proveedor de seguridad que se va a usar.

[in] eSpecification

Especifica el proveedor de seguridad que se va a usar.

[in] wszSecurityProvider

El nombre de archivo y el identificador del proveedor de seguridad. Un proveedor de seguridad puede ser un archivo en el equipo (la caja de seguridad) o un dispositivo de hardware que contenga la clave de máquina segura. La ruta de acceso a esta clave se obtiene llamando a DRMGetSecurityProvider.

[in] wszManifestCredentials

Estructura XrML firmada que especifica condiciones en el entorno. Para obtener información sobre cómo crear un manifiesto, consulte Creación de un manifiesto de aplicación.

[in] wszMachineCredentials

El certificado de máquina.

[out] phEnv

Puntero a un identificador de entorno. Cierre el identificador llamando a DRMCloseEnvironmentHandle.

[out] phDefaultLibrary

Puntero al identificador de la biblioteca utilizada para crear el objeto principal. Debe cerrar este identificador antes de cerrar el identificador del entorno. Para obtener más información, vea la sección Comentarios. Cierre llamando a DRMCloseHandle.

Valor devuelto

Si la función se realiza correctamente, la función devuelve S_OK.

Si se produce un error en la función, devuelve un valor HRESULT que indica el error. Entre los valores posibles se incluyen, entre otros, los de la lista siguiente. Para obtener una lista de códigos de error comunes, consulte Valores HRESULT comunes.

Comentarios

Esta función carga la caja de seguridad y se asegura de que solo se cargan los archivos DLL legales, según el manifiesto.

El orden de los certificados es de menos confianza en primer lugar a más de confianza (más cercano a la raíz) por último.

Al cerrar los identificadores devueltos por esta función, cierre el identificador de biblioteca antes de cerrar el identificador del entorno. De lo contrario, recibirá un error de E_DRM_ENV_NOT_LOADED . Cierre el identificador de biblioteca llamando a DRMCloseHandle. Cierre el identificador del entorno llamando a DRMCloseEnvironmentHandle.

Requisitos

Requisito	Value
Plataforma de destino	Windows
Encabezado	msdrm.h
Library	Msdrm.lib
Archivo DLL	Msdrm.dll

Consulte también

Funciones de AD RMS