Método Settings.requestMediaAccessRights

[O recurso associado a esta página, Reprodutor Multimídia do Windows SDK, é um recurso herdado. Foi substituído pelo MediaPlayer. O MediaPlayer foi otimizado para Windows 10 e Windows 11. A Microsoft recomenda fortemente que o novo código use o MediaPlayer em vez de Reprodutor Multimídia do Windows SDK, 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 requestMediaAccessRights solicita um nível especificado de acesso à biblioteca.

Sintaxe

bRetVal = Settings.requestMediaAccessRights(
  access
)

Parâmetros

access [in]

Cadeia de caracteres que especifica o nível de direitos de acesso desejado. Contém um dos seguintes valores.

Cadeia de caracteres	Descrição
nenhum	Somente direitos de acesso a itens atuais.
read	Somente direitos de acesso de leitura.
completa	Direitos de acesso de leitura/gravação.

Retornar valor

Esse método retorna um valor booliano que indica se os direitos de acesso solicitados foram concedidos.

Comentários

Uma página da Web deve primeiro solicitar permissão do usuário para ler ou gravar dados na biblioteca. Invocar esse método solicita ao usuário uma caixa de diálogo que solicita o nível de permissão especificado. Isso significa que determinados métodos, propriedades e eventos ficarão inacessíveis no código se os direitos de acesso apropriados não tiverem sido concedidos. O nível de direitos de acesso atual pode ser recuperado usando Configurações. mediaAccessRights.

Reprodutor Multimídia do Windows 10 Mobile: esse método sempre retorna true.

Requisitos

Requisito	Valor
Versão	Reprodutor Multimídia do Windows série 9 ou posterior.
DLL	Wmp.dll

Confira também

Objeto Settings

Settings.mediaAccessRights