Método IMFContentEnabler::GetEnableURL (mfidl.h)

  • Artigo

Recupera uma URL para executar uma ação manual de habilitação de conteúdo.

Sintaxe

HRESULT GetEnableURL(
  [out]     LPWSTR              *ppwszURL,
  [out]     DWORD               *pcchURL,
  [in, out] MF_URL_TRUST_STATUS *pTrustStatus
);

Parâmetros

[out] ppwszURL

Recebe um ponteiro para um buffer que contém a URL. O chamador deve liberar a memória do buffer chamando CoTaskMemFree.

[out] pcchURL

Recebe o número de caracteres retornados em ppwszURL, incluindo o caractere NULL de terminação.

[in, out] pTrustStatus

Recebe um membro da enumeração MF_URL_TRUST_STATUS indicando se a URL é confiável.

Valor retornado

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.
MF_E_NOT_AVAILABLE
 Nenhuma URL está disponível.

Comentários

Se a ação de habilitação puder ser executada navegando até uma URL, esse método retornará a URL. Se essa URL não existir, o método retornará um código de falha.

A finalidade da URL depende do tipo de habilitador de conteúdo, que é obtido chamando IMFContentEnabler::GetEnableType.

Habilitar tipo Finalidade da URL
Individualização Não aplicável.
Aquisição de licença URL para obter a licença. Chame IMFContentEnabler::GetEnableData e envie os dados para a URL como uma solicitação HTTP POST. Para receber notificação quando a licença for adquirida, chame IMFContentEnabler::MonitorEnable.
Revogação URL para uma página da Web em que o usuário pode baixar e instalar um componente atualizado.

Requisitos

   
Cliente mínimo com suporte Windows Vista [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows Server 2008 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho mfidl.h
Biblioteca Mfuuid.lib

Confira também

Como reproduzir arquivos de mídia protegidos

IMFContentEnabler