Função SetupGetInfPublishedNameW (setupapi.h)

A função SetupGetInfPublishedName recupera o nome de arquivo totalmente qualificado (caminho do diretório e nome do arquivo) de um arquivo INF no diretório de arquivos INF do sistema que corresponde a um arquivo INF especificado no repositório de driver ou um arquivo INF especificado no diretório de arquivos INF do sistema.

Sintaxe

WINSETUPAPI BOOL SetupGetInfPublishedNameW(
  [in]            PCWSTR DriverStoreLocation,
  [out]           PWSTR  ReturnBuffer,
  [in]            DWORD  ReturnBufferSize,
  [out, optional] PDWORD RequiredSize
);

Parâmetros

[in] DriverStoreLocation

Um ponteiro para uma cadeia de caracteres terminada em NULL que contém o nome de arquivo totalmente qualificado (caminho do diretório e nome do arquivo) de um arquivo INF no repositório de driver. Como alternativa, esse parâmetro é um ponteiro para uma cadeia de caracteres terminada em NULL que contém o nome e, opcionalmente, o caminho completo do diretório, de um arquivo INF no diretório de arquivos INF do sistema. Para obter mais informações sobre como especificar o arquivo INF, consulte a seção Comentários a seguir.

[out] ReturnBuffer

Um ponteiro para o buffer no qual SetupGetInfPublishedName retorna uma cadeia de caracteres terminada em NULL que contém o nome de arquivo totalmente qualificado do arquivo INF especificado no diretório INF do sistema. O tamanho máximo do caminho é MAX_PATH. Esse ponteiro pode ser definido como NULL. Para obter informações sobre como determinar o tamanho necessário do buffer de retorno, consulte a seção Comentários a seguir.

[in] ReturnBufferSize

O tamanho, em caracteres, do buffer fornecido por ReturnBuffer.

[out, optional] RequiredSize

Um ponteiro para uma variável do tipo DWORD que recebe o tamanho, em caracteres, do buffer ReturnBuffer . Esse parâmetro é opcional e pode ser definido como NULL.

Retornar valor

Se SetupGetInfPublishedName for bem-sucedido, a função retornará TRUE; caso contrário, a função retornará FALSE. Para obter informações de erro estendidas, chame GetLastError.

Se o tamanho, em caracteres, do nome de arquivo totalmente qualificado do arquivo INF solicitado, incluindo um terminador nulo, for maior que ReturnBufferSize, a função falhará e uma chamada para GetLastError retornará ERROR_INSUFFICIENT_BUFFER.

Comentários

Para determinar o tamanho do buffer de retorno necessário para conter o nome de arquivo totalmente qualificado do arquivo INF especificado no diretório INF do sistema, chame SetupGetInfPublishedName e defina ReturnBuffer como NULL, ReturnBufferSize como zero e forneça RequiredSize. SetupGetInfPublishedName retornará o tamanho do buffer necessário em RequiredSize.

Quando a instalação do dispositivo pré-instala um pacote de driver no repositório de driver, ele cria duas cópias do arquivo INF do pacote de driver. A instalação do dispositivo adiciona uma cópia ao diretório INF do sistema e atribui a essa cópia do arquivo INF um nome de arquivo publicado exclusivo do formulário OEMnnn.inf. A instalação do dispositivo adiciona uma segunda cópia do arquivo INF ao repositório de driver e atribui que copia o nome do arquivo INF original.

SetupGetInfPublishedName retorna o nome de arquivo totalmente qualificado do arquivo INF no diretório de arquivos INF do sistema que corresponde ao arquivo INF, se houver, fornecido pelo DriverStoreLocation. DriverStoreLocation deve especificar o nome de arquivo totalmente qualificado de um arquivo INF no repositório de driver ou deve especificar o nome do arquivo e, opcionalmente, o caminho do diretório, de um arquivo INF no diretório INF do sistema. Por exemplo, suponha que o arquivo INF de um pacote de driver seja myinf.inf e que, para esse pacote de driver, a instalação do dispositivo instale o arquivo INF OEM1.inf no diretório INF do sistema C:\Windows\inf. Suponha ainda que a instalação do dispositivo instale a cópia de arquivo INF correspondente C:\windows\system32\driverstore\filerepository\myinf_12345678\myinf.inf no repositório de driver. Nesse caso, a função retornará C:\Windows\inf\OEM1.inf se DriverStoreLocation fornecer uma das seguintes cadeias de caracteres: C:\windows\system32\driverstore\filerepository\myinf_12345678\myinf.inf, OEM1.inf ou C:\Windows\inf\OEM1.inf.

Chame a função SetupGetInfDriverStoreLocation para recuperar o nome de arquivo totalmente qualificado de um arquivo INF no repositório de driver que corresponde a um arquivo INF especificado no diretório de arquivos INF do sistema ou um arquivo especificado no repositório de driver.

Observação

O cabeçalho setupapi.h define SetupGetInfPublishedName como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Disponível no Windows Vista e versões posteriores do Windows.
Plataforma de Destino	Área de Trabalho
Cabeçalho	setupapi.h (inclua Setupapi.h)
Biblioteca	Setupapi.lib

Confira também

SetupGetInfDriverStoreLocation