Função SetupPromptForDiskA (setupapi.h)

[Essa função está disponível para uso nos sistemas operacionais indicados na seção Requisitos. Ele pode estar alterado ou indisponível em versões subsequentes. SetupAPI não deve mais ser usado para instalar aplicativos. Em vez disso, use o Windows Installer para desenvolver instaladores de aplicativos. SetupAPI continua a ser usado para instalar drivers de dispositivo.]

A função SetupPromptForDisk exibe uma caixa de diálogo que solicita ao usuário um disco.

Sintaxe

WINSETUPAPI UINT SetupPromptForDiskA(
  [in]      HWND   hwndParent,
  [in]      PCSTR  DialogTitle,
  [in]      PCSTR  DiskName,
  [in]      PCSTR  PathToSource,
  [in]      PCSTR  FileSought,
  [in]      PCSTR  TagFile,
  [in]      DWORD  DiskPromptStyle,
  [in, out] PSTR   PathBuffer,
  [in]      DWORD  PathBufferSize,
  [in, out] PDWORD PathRequiredSize
);

Parâmetros

[in] hwndParent

Manipule para a janela pai para esta caixa de diálogo.

[in] DialogTitle

Ponteiro opcional para um cadeia de caracteresterminada nula especificando o título da caixa de diálogo. Se esse parâmetro for NULL, o padrão de ""%s--Files Needed"" (localizado) será usado. O "%s" é substituído pelo texto recuperado da janela pai. Se nenhum texto for recuperado da janela pai, o título será "Arquivos Necessários".

[in] DiskName

Ponteiro opcional para uma cadeia de caracteres terminada especificando o nome do disco a ser inserido. Se esse parâmetro for NULL, o padrão "(Desconhecido)" (localizado) será usado.

[in] PathToSource

Ponteiro opcional para um cadeia de caracteresterminada nula especificando a parte do caminho do local esperado do arquivo, por exemplo, F:\x86. Se não for especificado, o caminho em que SetupPromptForDisk localizado mais recentemente um arquivo é usado. Se essa lista estiver vazia, um padrão do sistema será usado.

[in] FileSought

Ponteiro para um cadeia de caracteres nulaterminada especificando o nome do arquivo necessário (somente parte do nome do arquivo). O nome do arquivo será exibido se o usuário clicar no botão Procurar. Essa rotina procura o arquivo usando seus nomes de formulário compactados; portanto, você pode passar cmd.exe e não se preocupar que o arquivo realmente exista como cmd.ex_ na mídia de origem.

[in] TagFile

Ponteiro opcional para um cadeia de caracteres nulaterminada especificando um arquivo de marca (somente parte de nome de arquivo) que identifica a presença de um volume de mídia removível específico. Se o caminho selecionado no momento colocar o arquivo na mídia removível e um arquivo de marca for especificado, SetupPromptForDisk procurará o arquivo de marca na raiz da unidade para determinar se deseja continuar.

Por exemplo, se PathToSource for A:\x86, o tagfile será disk1.tag e o usuário digitar B:\x86 no controle de edição da caixa de diálogo prompt, a rotina procurará B:\disk1.tag para determinar se deve continuar. Se o arquivo de marca não for encontrado, a função procurará o tagfile usando PathToSource.

Se um arquivo de marca não for especificado, a mídia removível funcionará como mídia não removível e FileSought será procurado antes de continuar.

[in] DiskPromptStyle

Especifica o comportamento da caixa de diálogo. Esse parâmetro pode ser uma combinação dos sinalizadores a seguir.

IDF_CHECKFIRST

Verifique o arquivo/disco antes de exibir a caixa de diálogo do prompt e, se presente, retornar DPROMPT_SUCCESS imediatamente.

IDF_NOBEEP

Impeça que a caixa de diálogo apita para chamar a atenção do usuário quando ela for exibida pela primeira vez.

IDF_NOBROWSE

Não exiba a opção procurar.

IDF_NOCOMPRESSED

Não verifique se há versões compactadas do arquivo de origem.

IDF_NODETAILS

Não exiba informações detalhadas.

IDF_NOFOREGROUND

Impedir que a caixa de diálogo se torne a janela de primeiro plano.

IDF_NOSKIP

Não exiba a opção ignorar.

IDF_OEMDISK

Solicitar um disco fornecido por um fabricante de hardware.

IDF_WARNIFSKIP

Avisar o usuário de que ignorar um arquivo pode afetar a instalação.

[in, out] PathBuffer

Ponteiro opcional para um buffer que, ao retornar, recebe o caminho (sem nome de arquivo) do local especificado pelo usuário por meio da caixa de diálogo. Você deve usar uma cadeia de caracteresterminada nula. O cadeia de caracteres terminada pornula não deve exceder o tamanho do buffer de destino. Você pode chamar a função uma vez para obter o tamanho do buffer necessário, alocar a memória necessária e, em seguida, chamar a função uma segunda vez para recuperar os dados. Usando essa técnica, você pode evitar erros devido a um tamanho de buffer insuficiente. Consulte a seção Comentários.

[in] PathBufferSize

Tamanho do buffer apontado por PathBuffer, em caracteres. Deve ser pelo menos MAX_PATH longo. Isso inclui o terminador de nulo .

[in, out] PathRequiredSize

Ponteiro opcional para uma variável que recebe o tamanho necessário para PathBuffer, em caracteres. Isso inclui o terminador de nulo .

Valor de retorno

A função retorna um dos valores a seguir.

Para obter informações de erro estendidas, chame GetLastError.

Observações

Se essa função for chamada com um PathBuffer de NULL e um PathBufferSize de zero, a função colocará o tamanho do buffer necessário para manter os dados especificados na variável apontada por PathRequiredSize. Se a função tiver êxito nisso, o valor retornado será NO_ERROR. Caso contrário, o valor retornado é um dos valores descritos na seção Valores retornados.

Requisitos

Consulte também

Funções

Visão geral

SetupCopyError

SetupDeleteError

SetupRenameError