Método IWMDRMSecurity::GetMachineCertificate

[O recurso associado a esta página, Windows Media Format 11 SDK, é um recurso herdado. Ele foi substituído por Leitor de Origem e Gravador de Coletor. O Leitor de Origem e o Gravador do Coletor foram otimizados para Windows 10 e Windows 11. A Microsoft recomenda fortemente que o novo código use o Leitor de Origem e o Gravador do Coletor em vez do SDK do Windows Media Format 11, quando possível. A Microsoft sugere que o código existente que usa as APIs herdadas seja reescrito para usar as novas APIs, se possível.]

O método GetMachineCertificate recupera o certificado do computador do subsistema DRM no computador cliente.

Sintaxe

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

Parâmetros

dwCertificateType [in]

Tipo de certificado a ser recuperado. Defina como um dos valores na tabela a seguir.

Valor	Descrição
WMDRM_CERTIFICATE_TYPE_V1	O certificado será recuperado no formato usado pelos componentes herdados.
WMDRM_CERTIFICATE_TYPE_V2	O certificado será recuperado no formato usado pelos componentes do Windows Vista.

rgbVersion[4] [out]

Matriz de quatro bytes especificando a versão do subsistema DRM no computador cliente.

ppbCertificate [out]

Endereço de uma variável que recebe um ponteiro para os dados do certificado. Defina como NULL para que o método forneça o tamanho do buffer necessário para manter o certificado em pcbCertificate.

pcbCertificate [in, out]

Tamanho do certificado em bytes. Se ppbCertificate for NULL, esse valor será definido como o tamanho do certificado. Se ppbCertificate não for NULL, esse valor deverá ser definido como o tamanho do buffer.

Retornar valor

O método retorna um HRESULT. Os possíveis valores incluem, mas sem limitação, aqueles na tabela a seguir.

Código de retorno	Descrição
S_OK	O método foi bem-sucedido.

Requisitos

Requisito	Valor
parâmetro	Wmdrmsdk.h
Biblioteca	Wmdrmsdk.lib

Confira também

IWMDRMSecurity Interface