Entradas autorun.inf

Este tópico é uma referência para as entradas que podem ser usadas em um arquivo Autorun.inf. Uma entrada consiste em uma chave e um valor.

• chaves [AutoRun]
  • de ação
  • CustomEvent
  • ícone
  • rótulo
  • abrir
  • UseAutoPlay
  • shellexecute
  • shell
  • shell\verbo
• chaves [conteúdo]
• chaves [ExclusiveContentPaths]
• chaves [IgnoreContentPaths]
• chaves [DeviceInstall]
  • do DriverPath

[AutoRun] Chaves

• de ação
• CustomEvent
• ícone
• rótulo
• abrir
• UseAutoPlay
• shellexecute
• shell
• shell\verbo

ação

A ação entrada especifica o texto usado na caixa de diálogo De reprodução automática para o manipulador que representa o programa especificado no aberto ou entrada shellexecute no arquivo Autorun.inf da mídia. O valor pode ser expresso como texto ou como um recurso armazenado em um binário.

action=ActionText

action=@[filepath\]filename,-resourceID

Parâmetros

• ActionText

  Texto usado na caixa de diálogo De reprodução automática para o manipulador que representa o programa especificado no abrir ou entrada shellexecute no arquivo Autorun.inf da mídia.

• de caminho de arquivo

  Uma cadeia de caracteres que contém o caminho totalmente qualificado do diretório que contém o arquivo binário que contém a cadeia de caracteres. Se nenhum caminho for especificado, o arquivo deverá estar no diretório raiz da unidade.

• de nome de arquivo

  Uma cadeia de caracteres que contém o nome do arquivo binário.

• resourceID

  A ID da cadeia de caracteres dentro do arquivo binário.

Observações

A ação chave é usada apenas no Windows XP Service Pack 2 (SP2) ou posterior. Ele só tem suporte para unidades do tipo DRIVE_REMOVABLE e DRIVE_FIXED. No caso de DRIVE_REMOVABLE, a ação chave é necessária. Uma ação comando no arquivo Autorun.inf de um CD de áudio ou DVD de filme é ignorada e essas mídias continuam a se comportar como no Windows XP Service Pack 1 (SP1) e anteriores.

A cadeia de caracteres exibida na caixa de diálogo De reprodução automática é construída combinando o texto especificado na ação entrada com texto embutido em código nomeando o provedor, fornecido pelo Shell. O ícone é exibido ao lado dele. Essa entrada sempre aparece como a primeira opção na caixa de diálogo Reprodução Automática e é selecionada por padrão. Se o usuário aceitar a opção, o aplicativo especificado pelo abrir ou entrada shellexecute no arquivo Autorun.inf da mídia será iniciado. A opção Sempre executar a ação selecionada não está disponível nessa situação.

A ação e o ícone chaves juntos definem a representação do aplicativo que é visto pelo usuário final na caixa de diálogo Reprodução Automática. Eles devem ser compostos de forma que os usuários possam identificá-los facilmente. Eles devem indicar o aplicativo a ser executado, a empresa que o criou e qualquer identidade visual associada.

Para compatibilidade com versões anteriores, a ação entrada é opcional para dispositivos do tipo DRIVE_FIXED. Para esse tipo, uma entrada padrão será usada na caixa de diálogo Reprodução automática se nenhuma ação entrada estiver presente no arquivo Autorun.inf.

A ação entrada é obrigatória para dispositivos do tipo DRIVE_REMOVABLE, que até agora não tinham suporte ao Autorun.inf. Se nenhuma ação entrada estiver presente, a caixa de diálogo De reprodução automática será exibida, mas sem nenhuma opção para iniciar o conteúdo adicional.

CustomEvent

A entrada CustomEvent especifica um evento de conteúdo personalizado de Reprodução Automática.

CustomEvent=CustomEventName

Parâmetros

• CustomEventName

  Uma cadeia de caracteres de texto que contém o nome do evento de conteúdo de Reprodução Automática. O nome não deve ter mais de 100 caracteres alfanuméricos.

Observações

Você pode incluir um nome de evento personalizado no arquivo Autorun.inf de um volume. Quando a Reprodução Automática solicita que o usuário use um aplicativo com o volume, ele exibe apenas aplicativos registrados para o nome do evento personalizado especificado. Para obter informações sobre como você pode registrar um aplicativo como um manipulador para o evento de conteúdo de Reprodução Automática personalizado, consulte Inicialização automática com de Reprodução Automática ou Como registrar um manipulador de eventos.

O exemplo a seguir especifica o valor "MyContentOnArrival" como um novo evento de conteúdo de Reprodução Automática.

CustomEvent=MyContentOnArrival

ícone

O ícone entrada especifica um ícone que representa a unidade habilitada para AutoRun na interface do usuário do Windows.

icon=iconfilename[,index]

Parâmetros

• iconfilename

  Nome de um arquivo .ico, .bmp, .exeou .dll que contém as informações do ícone. Se um arquivo contiver mais de um ícone, você também deverá especificar o índice baseado em zero do ícone.

Observações

O ícone, juntamente com o rótulo, representa a unidade habilitada para AutoRun na interface do usuário do Windows. Por exemplo, no Windows Explorer, a unidade é representada por esse ícone em vez do ícone de unidade padrão. O arquivo do ícone deve estar no mesmo diretório do arquivo especificado pelo comando abrir.

O exemplo a seguir especifica o segundo ícone no arquivo MyProg.exe.

icon=MyProg.exe,1

etiqueta

O rótulo entrada especifica um rótulo de texto que representa a unidade habilitada para AutoRun na interface do usuário do Windows.

label=LabelText

Parâmetros

• LabelText

  Uma cadeia de caracteres de texto que contém o rótulo. Ele pode conter espaços e não deve ter mais de 32 caracteres.

Observações

O rótulo, juntamente com um ícone, representa a unidade habilitada para AutoRun na interface do usuário do Windows.

O exemplo a seguir especifica o valor "My Drive Label" como o rótulo da unidade.

label=My Drive Label

abrir

O abrir entrada especifica o caminho e o nome do arquivo do aplicativo que o AutoRun inicia quando um usuário insere um disco na unidade.

open=[exepath\]exefile [param1 [param2] ...] 

Parâmetros

• de bloco

  Caminho totalmente qualificado de um arquivo executável que é executado quando o CD é inserido. Se apenas um nome de arquivo for especificado, ele deverá estar no diretório raiz da unidade. Para localizar o arquivo em um subdiretório, você deve especificar um caminho. Você também pode incluir um ou mais parâmetros de linha de comando para passar para o aplicativo de inicialização.

UseAutoPlay

No Windows XP, a entrada UseAutoPlay especifica que a Reprodução Automática deve ser usada em vez de Executar Automaticamente.

No Windows Vista e posterior, essa entrada faz com que todas as ações especificadas para a Execução Automática (usando o abrir ou entradas de shellexecute) sejam suprimidas da caixa de diálogo Reprodução Automática. Essa entrada não tem efeito sobre versões do Windows anteriores ao Windows XP.

No Windows 8 e posterior, especificar um valor 0 desabilitará a reprodução automática para este dispositivo.

Parâmetros

Para usar essa opção, adicione uma entrada para UseAutoPlay ao arquivo Autorun.inf e defina a entrada como 1. Nenhum outro valor tem suporte em versões do Windows anteriores ao Windows 8.

No Windows 8 e posterior, especifique um valor de 0 para desabilitar a reprodução automática para este dispositivo.

UseAutoPlay=1

Observações

Atualmente, UseAutoPlay é aplicável somente no Windows XP ou posterior e somente em uma unidade que GetDriveType determina ser do tipo DRIVE_CDROM.

Quando UseAutoPlay é usado, qualquer ação especificada pelo abrir ou entradas de shellexecute no Autorun.inf é ignorada no Windows XP e omitida da caixa de diálogo Reprodução Automática no Windows Vista.

O AutoRun normalmente é usado para executar ou carregar automaticamente algo contido na mídia inserida, enquanto a Reprodução Automática apresenta uma caixa de diálogo que inclui uma lista de ações relevantes que podem ser executadas e permite que o usuário escolha qual ação tomar. Para obter mais informações sobre a diferença entre a Execução Automática e a Reprodução Automática, consulte Criando um aplicativo CD-ROM habilitado para Execução Automática e Usando e Configurandode Reprodução Automática, respectivamente.

Exemplo de uso

Um CD contém três arquivos: Autorun.inf, Readme.txte Music.wma. Dependendo da versão do Windows em uso e das opções especificadas em Autorun.inf, o CD pode ser manipulado por AutoRun ou Reprodução Automática quando ele é inserido (supondo que a AutoRun/Reprodução Automática esteja habilitada para a unidade na qual o CD está inserido).

Primeiro, considere um arquivo Autorun.inf com o seguinte conteúdo, observando que UseAutoPlay=1 não está especificado:

[AutoRun]
shellexecute="Readme.txt"

A ação executada pelo Shell quando este CD é inserido depende da versão do Windows em uso:

• No Windows XP ou anterior, esse CD é tratado pela Execução Automática quando é inserido. Nesse caso, a entrada shellexecute é lida e o Shell invoca o manipulador de arquivos associado a arquivos .txt; normalmente, isso abriria Readme.txt no Bloco de Notas.
• No Windows Vista, a presença de um arquivo Autorun.inf com uma entrada shellexecute faz com que a mídia seja identificada como tipo de Reprodução Automática "Software e jogos". Nesse caso, o usuário é presenteado com uma caixa de diálogo de Reprodução Automática que inclui a ação especificada pela entrada shellexecute (apresentada como "Carregar Readme.txt" na caixa de diálogo), juntamente com ações padrão associadas à mídia do tipo "Software e jogos".

Para indicar que a Reprodução Automática deve ser usada em vez de Executar Automaticamente no Windows XP e que a ação especificada pela entrada shellexecute de Execução Automática deve ser suprimida da caixa de diálogo Reprodução Automática no Windows Vista, insira UseAutoPlay no arquivo Autorun.inf da seguinte maneira:

[AutoRun]
shellexecute="Readme.txt"
UseAutoPlay=1

Mais uma vez, a ação executada pelo Shell quando esse CD é inserido depende da versão do Windows em uso.

• Em versões do Windows anteriores ao Windows XP, a Execução Automática ainda é usada e a ação especificada por shellexecute é executada, conforme descrito anteriormente. (Observe que apenas a Execução Automática está disponível em versões do Windows anteriores ao Windows XP.)
• No Windows XP, a entrada UseAutoPlay faz com que a Reprodução Automática seja usada no lugar de AutoRun. Nesse caso, a Reprodução Automática determina que a mídia contém um arquivo de Áudio de Mídia do Windows (.wma) e categoriza o conteúdo como "Arquivos de música". O usuário é apresentado com uma caixa de diálogo AutoPlay que contém manipuladores registrados para o tipo de mídia "Arquivos de música" Reprodução Automática; a entrada shellexecute do AutoRun é ignorada.

shellexecute

Versão 5.0. A entrada shellexecute especifica um aplicativo ou arquivo de dados que o AutoRun usará para chamar ShellExecuteEx.

shellexecute=[filepath\]filename[param1, [param2]...] 

Parâmetros

• de caminho de arquivo

  Uma cadeia de caracteres que contém o caminho totalmente qualificado do diretório que contém os dados ou o arquivo executável. Se nenhum caminho for especificado, o arquivo deverá estar no diretório raiz da unidade.

• de nome de arquivo

  Uma cadeia de caracteres que contém o nome do arquivo. Se for um arquivo executável, ele será iniciado. Se for um arquivo de dados, ele deverá ser um membro de um tipo de arquivo . ShellExecuteEx inicia o comando padrão associado ao tipo de arquivo.

• paramx

  Contém quaisquer parâmetros adicionais que devem ser passados para ShellExecuteEx.

Observações

Essa entrada é semelhante a aberto, mas permite que você use informações de associação de arquivos para executar o aplicativo.

concha

A entrada shell especifica um comando padrão para o menu de atalho da unidade.

shell=verb

Parâmetros

• verbo

  O verbo que corresponde ao comando de menu. O verbo e seu comando de menu associado devem ser definidos no arquivo Autorun.inf com uma entrada shell\verbo.

Observações

Quando um usuário clica com o botão direito do mouse no ícone da unidade, um menu de atalho é exibido. Se um arquivo Autorun.inf estiver presente, o comando de menu de atalho padrão será tirado dele. Esse comando também é executado quando o usuário clica duas vezes no ícone da unidade.

Para especificar o comando de menu de atalho padrão, primeiro defina seu verbo, cadeia de caracteres de comando e texto de menu com shell\verbo. Em seguida, use o shell para torná-lo o comando de menu de atalho padrão. Caso contrário, o texto do item de menu padrão será "Reprodução Automática", que inicia o aplicativo especificado pelo abrir entrada.

shell\verbo

A entrada shell\verbo adiciona um comando personalizado ao menu de atalho da unidade.

shell\verb\command=Filename.exe 
shell\verb=MenuText

Parâmetros

• verbo

  O verbo do comando de menu. O shell\verbo\command entrada associa o verbo a um arquivo executável. Os verbos não devem conter espaços inseridos. Por padrão, verbo é o texto exibido no menu de atalho.

• Filename.exe

  O caminho e o nome do arquivo do aplicativo que executa a ação.

• MenuText

  Esse parâmetro especifica o texto exibido no menu de atalho. Se for omitido, verbo será exibido. MenuText pode ser de maiúsculas e minúsculas e pode conter espaços. Você pode definir uma tecla de atalho para o item de menu colocando um e comercial (&) na frente da letra.

Observações

Quando um usuário clica com o botão direito do mouse no ícone da unidade, um menu de atalho é exibido. Adicionar shell\verbo entradas ao arquivo Autorun.inf da unidade permite adicionar comandos a esse menu de atalho.

Há duas partes nessa entrada, que devem estar em linhas separadas. A primeira parte é shell\verbo\command. É necessário. Ele associa uma cadeia de caracteres, chamada verbo, ao aplicativo a ser iniciado quando o comando é executado. A segunda parte é o **shell\**verbo entrada. É opcional. Você pode incluí-lo para especificar o texto exibido no menu de atalho.

Para especificar um comando de menu de atalho padrão, defina o verbo com shell\verboe torne-o o comando padrão com a entrada shell.

O fragmento autorun.inf de exemplo a seguir associa o verbo readit com a cadeia de caracteres de comando "Bloco de notas abc\readme.txt". O texto do menu é "Ler-me" e "M" é definido como a tecla de atalho do item. Quando o usuário seleciona esse comando, o arquivo abc\readme.txt da unidade é aberto com o Microsoft Notepad.

shell\readit\command=notepad abc\readme.txt 
shell\readit=Read &Me

[Conteúdo] Chaves

Há três chaves de tipo de arquivo: MusicFiles, PictureFilese VideoFiles.

Se um desses conteúdos for definido como true por meio de um dos valores que não diferenciam maiúsculas de minúsculas 1, y, sim, t ou true, a interface do usuário de reprodução automática exibirá os manipuladores associados a esse tipo de conteúdo, independentemente de o conteúdo desse tipo existir na mídia.

Se um desses conteúdos for definido como false por meio de um dos valores que não diferenciam maiúsculas de minúsculas 0, n, não, f ou false, a interface do usuário de reprodução automática não exibirá os manipuladores associados a esse tipo de conteúdo, mesmo que o conteúdo desse tipo seja detectado na mídia.

O uso desta seção destina-se a permitir que os autores de conteúdo comuniquem a intenção do conteúdo com a reprodução automática. Por exemplo, um CD pode ser categorizado como contendo apenas conteúdo musical, embora também tenha imagens e vídeos e, de outra forma, seria visto como tendo conteúdo misto.

A seção [Conteúdo] só tem suporte no Windows Vista e posteriores.

[Content]
MusicFiles=Y
PictureFiles=0
VideoFiles=false

[ExclusiveContentPaths] Chaves

As pastas listadas nesta seção limitam a reprodução automática a pesquisar apenas essas pastas e suas subpastas em busca de conteúdo. Eles podem ser dados com ou sem uma barra invertida à esquerda (\). Em ambos os casos, eles são tomados como caminhos absolutos do diretório raiz da mídia. No caso de pastas com espaços em seus nomes, não coloque-as entre aspas, pois as aspas são tomadas literalmente como parte do caminho.

O uso desta seção destina-se a permitir que os autores de conteúdo comuniquem a intenção do conteúdo para a reprodução automática e reduzam o tempo de verificação limitando a verificação a determinadas áreas significativas da mídia.

A seguir estão todos os caminhos válidos

[ExclusiveContentPaths]
\music
\music\more music
music2

A seção [ExclusiveContentPaths] só tem suporte no Windows Vista e posteriores.

[IgnoreContentPaths] Chaves

As pastas listadas nesta seção e suas subpastas são ignoradas pela reprodução automática ao pesquisar conteúdo em uma mídia. Eles podem ser dados com ou sem uma barra invertida à esquerda (\). Em ambos os casos, eles são tomados como caminhos absolutos do diretório raiz da mídia. No caso de pastas com espaços em seus nomes, não coloque-as entre aspas, pois as aspas são tomadas literalmente como parte do caminho.

Os caminhos nesta seção têm precedência sobre caminhos na seção [ExclusiveContentPaths]. Se um caminho fornecido em [IgnoreContentPaths] for uma subpasta de um caminho fornecido em [ExclusiveContentPaths], ele ainda será ignorado.

O uso desta seção destina-se a permitir que os autores de conteúdo comuniquem a intenção do conteúdo para a reprodução automática e reduzam o tempo de verificação limitando a verificação a determinadas áreas significativas da mídia.

A seguir estão todos os caminhos válidos

[IgnoreContentPaths]
\music
\music\more music
music2

A seção [IgnoreContentPaths] só tem suporte no Windows Vista e posterior.

[DeviceInstall] Chaves

DriverPath

A entrada DriverPath especifica um diretório a ser pesquisado recursivamente em busca de arquivos de driver. Esse comando é usado durante uma instalação do driver e não faz parte de uma operação de AutoRun. A seção [DeviceInstall] só tem suporte no Windows XP.

[DeviceInstall]
DriverPath=directorypath

Parâmetros

• de diretório

  Um caminho para um diretório que o Windows pesquisa arquivos de driver, juntamente com todos os seus subdiretórios.

Observações

Não use letras de unidade em de diretório, pois elas mudam de um computador para o outro.

Para pesquisar vários diretórios, adicione uma entrada DriverPath para cada diretório como neste exemplo.

[DeviceInstall]
DriverPath=drivers\video 
DriverPath=drivers\audio

Se nenhuma entrada DriverPath for fornecida na seção [DeviceInstall] ou a entrada DriverPath não tiver nenhum valor, essa unidade será ignorada durante uma pesquisa por arquivos de driver.