Leer en inglés

Compartir a través de


Active Directory Rights Management Services SDK

Información general sobre la tecnología del SDK de Active Directory Rights Management Services.

Para desarrollar el SDK de Active Directory Rights Management Services, necesita estos encabezados:

Para obtener instrucciones de programación para esta tecnología, consulte:

Enumeraciones

 
DRM_DISTRIBUTION_POINT_INFO

Especifica el tipo de punto de distribución que se va a recuperar información sobre al llamar a DRMGetIssuanceLicenseInfo.
DRM_STATUS_MSG

Usado por la función de devolución de llamada personalizada para especificar por qué se llama a la función de devolución de llamada.
DRM_USAGEPOLICY_TYPE

Se usa con las funciones DRMGetUsagePolicy y DRMSetUsagePolicy para especificar un tipo de directiva de uso.
DRMATTESTTYPE

La enumeración DRMATTESTTYPE especifica qué tipo de firma se va a crear para un blob de datos.
DRMENCODINGTYPE

La enumeración DRMENCODINGTYPE identifica los posibles tipos de codificación usados en las licencias.
DRMGLOBALOPTIONS

Define los valores para especificar qué protocolo se usa para el protocolo de transporte y si se usa la caja de seguridad del servidor. Esta enumeración la usa la función DRMSetGlobalOptions.
DRMSECURITYPROVIDERTYPE

La enumeración DRMSECURITYPROVIDERTYPE especifica el tipo de entorno DRM seguro usado.
DRMSPECTYPE

La enumeración DRMSPECTYPE indica qué tipo de seguridad o proveedores de biblioteca se usan.
DRMTIMETYPE

La enumeración DRMTIMETYPE especifica un tipo de hora.

Functions

 
DRMAcquireAdvisories

Recupera listas de revocación requeridas por una licencia enviada.
DRMAcquireIssuanceLicenseTemplate

Recupera de forma asincrónica las plantillas de licencia de emisión de un servidor.
DRMAcquireLicense

Intenta adquirir de forma asincrónica una licencia de usuario final o un certificado de licencia de cliente.
DRMActivate

Obtiene un certificado de caja de seguridad y máquina para una máquina o un certificado de cuenta de derechos para un usuario.
DRMAddLicense

Agrega una licencia de usuario final al almacén de licencias temporal o permanente.
DRMAddRightWithUser

Asigna un derecho a un usuario en una licencia de emisión.
DRMAttest

La función DRMAttest ya no se admite y devuelve E_NOTIMPL.
DRMCALLBACK

Algunas de las funciones incluidas en el SDK de AD RMS proporcionan información de estado y licencias a la aplicación mediante una función de devolución de llamada que debe implementar. A continuación se muestra la sintaxis de devolución de llamada.
DRMCheckSecurity

Devuelve S_OK para cualquier nivel de la comprobación de seguridad que se está ejecutando.
DRMClearAllRights

Quita todos los derechos de una licencia de emisión existente.
DRMCloseEnvironmentHandle

Cierra un identificador de entorno.
DRMCloseHandle

Cierra los identificadores de los objetos creados con las funciones y bibliotecas DRMCreate* cargadas mediante DRMLoadLibrary.
DRMClosePubHandle

Cierra un DRMPUBHANDLE creado anteriormente.
DRMCloseQueryHandle

Cierra un identificador de un objeto de licencia independiente.
DRMCloseSession

Cierra una sesión de cliente o una sesión de almacenamiento de licencias.
DRMConstructCertificateChain

Crea una cadena de certificados a partir de un número arbitrario de certificados.
DRMCreateBoundLicense

Permite a una aplicación examinar o ejercer los derechos de una licencia almacenada localmente.
DRMCreateClientSession

Crea una sesión de cliente, que hospeda sesiones de almacenamiento de licencias y se usa en la activación y en otras llamadas de función.
DRMCreateEnablingBitsDecryptor

Crea un objeto de descifrado que se usa para descifrar los datos de contenido.
DRMCreateEnablingBitsEncryptor

Crea un objeto de cifrado de AD RMS que se usa para cifrar los datos de contenido.
DRMCreateEnablingPrincipal

Crea una entidad de seguridad que permite enlazar a una licencia.
DRMCreateIssuanceLicense

Crea una licencia de emisión desde cero, desde una plantilla o desde una licencia de emisión firmada.
DRMCreateLicenseStorageSession

Crea una sesión de almacenamiento de licencias, que es necesaria para adquirir o manipular una licencia.
DRMCreateRight

Crea un derecho XrML que definirá un derecho concedido a un usuario o grupo.
DRMCreateUser

Crea un usuario al que se le concederá un derecho.
DRMDecode

Descodifica una cadena codificada con un algoritmo común, como base64.
DRMDeconstructCertificateChain

Recupera un certificado especificado de una cadena de certificados.
DRMDecrypt

Descifra el contenido cifrado.
DRMDeleteLicense

Elimina una licencia, un certificado de licencia de cliente, una lista de revocación o una plantilla de licencia de emisión.
DRMDuplicateEnvironmentHandle

Crea una copia de un identificador de entorno.
DRMDuplicateHandle

Crea una copia de DRMHANDLE.
DRMDuplicatePubHandle

Realiza una copia de DRMPUBHANDLE.
DRMDuplicateSession

Duplica una sesión de almacenamiento de licencias o cliente.
DRMEncode

Codifica los datos mediante un método de codificación pública, como base64.
DRMEncrypt

Cifra los datos.
DRMEnumerateLicense

Enumera licencias válidas, certificados de equipo o certificados de cuenta de derechos, listas de revocación para el usuario actual o plantillas de licencia de emisión.
DRMGetApplicationSpecificData

Recupera un par nombre-valor de información arbitraria específica de la aplicación.
DRMGetBoundLicenseAttribute

Recupera un atributo de licencia enlazado de la licencia XrML.
DRMGetBoundLicenseAttributeCount

Recupera el número de repeticiones de un atributo en una licencia.
DRMGetBoundLicenseObject

Devuelve un objeto de una licencia enlazada.
DRMGetBoundLicenseObjectCount

Recupera el número de repeticiones de un objeto dentro de una rama especificada de una licencia.
DRMGetCertificateChainCount

Recupera el número de certificados de una cadena de certificados.
DRMGetClientVersion

Devuelve el número de versión del software cliente de Active Directory Rights Management Services y si la jerarquía es para fines de producción o preproducción.
DRMGetEnvironmentInfo

Devuelve información sobre un entorno seguro.
DRMGetInfo

Recupera información sobre el cifrado o el descifrado de objetos.
DRMGetIntervalTime

Recupera el número de días de emisión que se pueden pasar antes de que se deba renovar una licencia de usuario final.
DRMGetIssuanceLicenseInfo

Recupera información de una licencia de emisión.
DRMGetIssuanceLicenseTemplate

Obtiene una plantilla de licencia de emisión de una licencia de emisión existente.
DRMGetMetaData

Recupera los metadatos de una licencia de emisión.
DRMGetNameAndDescription

Recupera un nombre y una descripción específicos del idioma de una licencia de emisión.
DRMGetOwnerLicense

Recupera una licencia de propietario creada mediante una llamada a DRMGetSignedIssuanceLicense.
DRMGetProcAddress

Devuelve la dirección de una función de una biblioteca. Es la versión segura de la función GetProcAddress.
DRMGetRevocationPoint

Recupera información sobre el punto de revocación de una licencia de emisión.
DRMGetRightExtendedInfo

Recupera pares de nombre-valor personalizados adjuntos a una derecha.
DRMGetRightInfo

Obtiene información sobre un derecho creado anteriormente.
DRMGetSecurityProvider

Recupera la ruta de acceso a una caja de seguridad.
DRMGetServiceLocation

Recupera la dirección URL de un servidor que puede realizar varios servicios de administración de derechos, como la activación o la adquisición de licencias.
DRMGetSignedIssuanceLicense

Adquiere una licencia de emisión firmada en línea o sin conexión, o genera una licencia de emisión sin firmar que se puede firmar más adelante.
DRMGetSignedIssuanceLicenseEx

Adquiere una licencia de emisión firmada sin conexión.
DRMGetTime

Solicita un tiempo seguro desde el sistema de administración de derechos.
DRMGetUnboundLicenseAttribute

Recupera un atributo de licencia independiente del XrML subyacente.
DRMGetUnboundLicenseAttributeCount

Recupera el número de repeticiones de un atributo dentro de un objeto de una licencia independiente.
DRMGetUnboundLicenseObject

Recupera un objeto de un tipo especificado en una licencia independiente.
DRMGetUnboundLicenseObjectCount

Cuenta las instancias de un objeto dentro de una rama especificada de la licencia.
DRMGetUsagePolicy

Obtiene una directiva de uso que requiere o deniega el acceso al contenido en función del nombre de la aplicación, la versión u otras características de la aplicación.
DRMGetUserInfo

Obtiene información sobre un usuario.
DRMGetUserRights

Recupera los pares de usuario y derecho de una licencia de emisión.
DRMGetUsers

Recupera un usuario específico de una licencia de emisión.
DRMInitEnvironment

Crea un entorno seguro para todas las llamadas de rights management.
DRMIsActivated

Indica si se activa el usuario o la máquina actual.
DRMIsWindowProtected

Indica si una ventana está asociada a un entorno protegido.
DRMLoadLibrary

Carga un identificador en una biblioteca aprobada, según lo determinado por las credenciales.
DRMParseUnboundLicense

Crea un identificador para una licencia independiente, para permitir que una aplicación navegue por sus objetos y atributos.
DRMRegisterContent

Informa al cliente de Active Directory Rights Management Services (AD RMS) de que un documento protegido por AD RMS se está mostrando o que ya no se muestra.
DRMRegisterProtectedWindow

Registra una ventana en el entorno protegido.
DRMRegisterRevocationList

Registra una lista de revocación de derechos en el cliente.
DRMRepair

Repara un equipo cliente mediante la eliminación de certificados creados previamente para el equipo o el usuario.
DRMSetApplicationSpecificData

Permite que una licencia de emisión almacene pares de nombre-valor arbitrarios para su uso por parte de la aplicación que consume contenido.
DRMSetGlobalOptions

Establece el protocolo de transporte en un valor especificado y, opcionalmente, especifica si se usa la caja de seguridad del servidor.
DRMSetIntervalTime

Especifica el número de días de emisión que se pueden pasar antes de que se deba renovar una licencia de usuario final.
DRMSetMetaData

Agrega metadatos específicos de la aplicación a una licencia de emisión.
DRMSetNameAndDescription

Permite a una aplicación especificar nombres y descripciones de la licencia en varios idiomas (humanos).
DRMSetRevocationPoint

Establece una frecuencia de actualización y una ubicación para obtener una lista de revocación.
DRMSetUsagePolicy

Establece una directiva de uso que requiere o deniega el acceso al contenido en función del nombre de la aplicación, la versión u otras características del entorno.
DRMVerify

Ya no se admite y devuelve E_NOTIMPL.

Estructuras

 
DRM_ACTSERV_INFO

La estructura DRM_ACTSERV_INFO almacena información sobre el servidor de activación.
DRM_CLIENT_VERSION_INFO

Recibe información sobre la versión del cliente de Active Directory Rights Management Services (AD RMS) y la jerarquía, como producción o preproducción.
DRM_LICENSE_ACQ_DATA

Contiene los datos de adquisición de licencias durante la adquisición de licencias no válidas.
DRMBOUNDLICENSEPARAMS

Usado por DRMCreateBoundLicense para enlazar a una licencia.
DRMID

Identifica un objeto .