Função SetupGetInfPublishedNameW (setupapi.h)

A função SetupGetInfPublishedName recupera o nome do arquivo totalmente qualificado (caminho do diretório e o 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 a 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 do 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 por NULL que contém o nome e, opcionalmente, o caminho de diretório completo, 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 seguinte seção Comentários.

[in] ReturnBufferSize

O tamanho, em caracteres, do buffer fornecido pelo 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.

Valor de retorno

Se SetupGetInfPublishedName for bem-sucedida, a função retornará VERDADEIRO; 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.

Observações

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 para 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 copie 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.infe que, para esse pacote de driver, a instalação do dispositivo instale o arquivo INF OEM1.inf no diretório do INF do sistema C:\Windows\inf. Suponha ainda que a instalação do dispositivo instale a cópia do 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.infou 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.

Nota

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 do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Disponível no Windows Vista e versões posteriores do Windows.
da Plataforma de Destino	Área de trabalho
cabeçalho	setupapi.h (inclua Setupapi.h)
biblioteca	Setupapi.lib

Consulte também

SetupGetInfDriverStoreLocation