Compartir a través de


Método IWMDRMSecurity::GetMachineCertificate

[La característica asociada a esta página, WINDOWS Media Format 11 SDK, es una característica heredada. Se ha reemplazado por lector de origen y escritor receptor. Lector de origen y escritor receptor se han optimizado para Windows 10 y Windows 11. Microsoft recomienda encarecidamente que el nuevo código use lector fuente y escritor receptor en lugar del SDK de Windows Media Format 11, siempre que sea posible. Microsoft sugiere que el código existente que usa las API heredadas se reescriba para usar las nuevas API si es posible.

El método GetMachineCertificate recupera el certificado de equipo del subsistema DRM en el equipo cliente.

Sintaxis

HRESULT GetMachineCertificate(
  [in]      DWORD dwCertificateType,
  [out]     BYTE  rgbVersion[4],
  [out]     BYTE  **ppbCertificate,
  [in, out] DWORD *pcbCertificate
);

Parámetros

dwCertificateType [in]

Tipo de certificado que se va a recuperar. Establezca en uno de los valores de la tabla siguiente.

Value Descripción
WMDRM_CERTIFICATE_TYPE_V1 El certificado se recuperará en el formato utilizado por los componentes heredados.
WMDRM_CERTIFICATE_TYPE_V2 El certificado se recuperará en el formato usado por los componentes de Windows Vista.

rgbVersion[4] [out]

Matriz de cuatro bytes que especifica la versión del subsistema DRM en el equipo cliente.

ppbCertificate [out]

Dirección de una variable que recibe un puntero a los datos del certificado. Establézcalo en NULL para que el método proporcione el tamaño del búfer necesario para contener el certificado en pcbCertificate.

pcbCertificate [in, out]

Tamaño del certificado en bytes. Si ppbCertificate es NULL, este valor se establecerá en el tamaño del certificado. Si ppbCertificate no es NULL, este valor debe establecerse en el tamaño del búfer.

Valor devuelto

El método devuelve un valor HRESULT. Entre los valores posibles se incluyen los que se indican en la tabla siguiente, entre otros.

Código devuelto Descripción
S_OK
El método se ha llevado a cabo de forma correcta.

Requisitos

Requisito Value
Encabezado
Wmdrmsdk.h
Biblioteca
Wmdrmsdk.lib

Consulte también

Interfaz IWMDRMSecurity