estrutura WM_GET_LICENSE_DATA
[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 de 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 de 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.]
A estrutura WM_GET_LICENSE_DATA contém informações sobre onde adquirir uma licençadrm.
Sintaxe
typedef struct _WMGetLicenseData {
DWORD dwSize;
HRESULT hr;
WCHAR *wszURL;
WCHAR *wszLocalFilename;
BYTE *pbPostData;
DWORD dwPostDataSize;
} WM_GET_LICENSE_DATA;
Membros
-
dwSize
-
DWORD que contém o tamanho da estrutura WM_GET_LICENSE_DATA , em bytes.
-
h
-
HRESULT retorna o código.
-
wszURL
-
Cadeia de caracteres terminada em nulo de caractere largo que contém a URL de aquisição de licença. Use essa cadeia de caracteres e a cadeia de caracteres pbPostData na aquisição de licença não silenciosa.
-
wszLocalFilename
-
Cadeia de caracteres de caractere largo terminada em nulo que contém uma página HTML local que é gerada pelo componente DRM. Quando essa cadeia de caracteres é carregada em um navegador, ela redireciona automaticamente a solicitação HTTP para a URL de aquisição de licença, juntamente com os dados de postagem necessários. O uso dessa URL local agora foi preterido. A abordagem recomendada é usar as cadeias de caracteres wszURL e pbPostData .
-
pbPostData
-
Ponteiro para uma matriz de bytes que contém os dados a serem postados na URL de aquisição de licença. Você deve adicionar a seguinte cadeia de caracteres ao início da cadeia de caracteres pbPostData : "nonsilent=1&challenge=". Em seguida, a cadeia de caracteres resultante deve ser acrescentada a wszURL quando você forma a solicitação HTTP.
-
dwPostDataSize
-
DWORD que indica o tamanho de pbPostData sem a cadeia de caracteres "nonsilent=1&challenge=" referida em pbPostData.
Comentários
Essa estrutura preenchida será retornada no parâmetro pValue do método IWMStatusCallback::OnStatus se WMT_STATUS for igual a WMT_NO_RIGHTS_EX ou WMT_ACQUIRE_LICENSE. Para eventos WMT_NO_RIGHTS_EX, o membro de rh será NS_E_LICENSE_REQUIRED, NS_E_LICENSE_OUTOFDATE ou NS_E_LICENSE_INCORRECT_RIGHTS. Qualquer um desses erros indica que uma nova licença deve ser adquirida navegando até a URL no membro wszURL .
Para eventos WMT_ACQUIRE_LICENSE, o membro de rh passará a macro SUCCEEDED se uma licença tiver sido adquirida com êxito. Se esse evento for recebido após uma tentativa de aquisição silenciosa e o rh for igual a NS_E_DRM_LICENSE_NOTACQUIRED, ele indicará que somente a aquisição não silenciosa terá suporte do servidor de licença para essa licença.
O aplicativo de exemplo Audioplayer demonstra como usar corretamente as informações retornadas nessa estrutura.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte |
Windows 2000 Professional [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte |
Windows 2000 Server [somente aplicativos da área de trabalho] |
| Versão |
SDK do Windows Media Format 7 ou versões posteriores do SDK |
| Cabeçalho |
|