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
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de