Función SetupGetInfPublishedNameA (setupapi.h)
La función SetupGetInfPublishedName recupera el nombre de archivo completo (ruta de acceso de directorio y nombre de archivo) de un archivo INF de en el directorio de archivos INF del sistema que corresponde a un archivo INF especificado en el almacén de controladores o un archivo INF especificado en el directorio de archivos INF del sistema.
Sintaxis
WINSETUPAPI BOOL SetupGetInfPublishedNameA(
[in] PCSTR DriverStoreLocation,
[out] PSTR ReturnBuffer,
[in] DWORD ReturnBufferSize,
[out, optional] PDWORD RequiredSize
);
Parámetros
[in] DriverStoreLocation
Puntero a una cadena terminada en NULL que contiene el nombre de archivo completo (ruta de acceso de directorio y nombre de archivo) de un archivo INF en el almacén de controladores. Como alternativa, este parámetro es un puntero a una cadena terminada en NULL que contiene el nombre y, opcionalmente, la ruta de acceso completa del directorio, de un archivo INF en el directorio de archivos INF del sistema. Para obtener más información sobre cómo especificar el archivo INF, vea la siguiente sección Comentarios.
[out] ReturnBuffer
Puntero al búfer en el que SetupGetInfPublishedName devuelve una cadena terminada en NULL que contiene el nombre de archivo completo del archivo INF especificado en el directorio INF del sistema. El tamaño máximo de la ruta de acceso es MAX_PATH. Este puntero se puede establecer en NULL. Para obtener información sobre cómo determinar el tamaño necesario del búfer de retorno, consulte la siguiente sección Comentarios.
[in] ReturnBufferSize
Tamaño, en caracteres, del búfer proporcionado por ReturnBuffer.
[out, optional] RequiredSize
Puntero a una variable con tipo DWORD que recibe el tamaño, en caracteres, del búfer de ReturnBuffer. Este parámetro es opcional y se puede establecer en NULL.
Valor devuelto
Si setupGetInfPublishedName se realiza correctamente, la función devuelve TRUE; De lo contrario, la función devuelve FALSE. Para obtener información de error extendida, llame a GetLastError.
Si el tamaño, en caracteres, del nombre de archivo completo del archivo INF solicitado, incluido un terminador NULL, es mayor que ReturnBufferSize, se producirá un error en la función y se devolverá una llamada a GetLastError devolverá ERROR_INSUFFICIENT_BUFFER.
Observaciones
Para determinar el tamaño del búfer de retorno necesario para contener el nombre de archivo completo del archivo INF especificado en el directorio INF del sistema, llame a SetupGetInfPublishedName y establezca ReturnBuffer en NULL, ReturnBufferSize a cero y proporcione RequiredSize. setupGetInfPublishedName devolverá el tamaño de búfer necesario en RequiredSize.
Cuando la instalación del dispositivo preinstala un paquete de controladores en el almacén de controladores, crea dos copias del archivo INF del paquete de controladores. La instalación del dispositivo agrega una copia al directorio INF del sistema y asigna esa copia del archivo INF un nombre de archivo publicado único del formulario OEMnnn.inf. La instalación del dispositivo agrega una segunda copia del archivo INF al almacén de controladores y asigna esa copia del nombre de archivo INF original.
SetupGetInfPublishedName devuelve el nombre de archivo completo del archivo INF en el directorio de archivos INF del sistema que coincide con el archivo INF, si existe, proporcionado por DriverStoreLocation. DriverStoreLocation debe especificar el nombre de archivo completo de un archivo INF en el almacén de controladores o debe especificar el nombre de archivo y, opcionalmente, la ruta de acceso del directorio, de un archivo INF en el directorio INF del sistema. Por ejemplo, supongamos que el archivo INF de un paquete de controladores es myinf.inf, y que para este paquete de controladores, la instalación del dispositivo instala el archivo INF OEM1.inf en el directorio INF del sistema C:\Windows\inf. Supongamos además que la instalación del dispositivo instala la copia del archivo INF correspondiente C:\windows\system32\driverstore\filerepository\myinf_12345678\myinf.inf en el almacén de controladores. En este caso, la función devuelve C:\Windows\inf\OEM1.inf si DriverStoreLocation proporciona una de las siguientes cadenas: C:\windows\system32\driverstore\filerepository\myinf_12345678\myinf.inf, OEM1.info C:\Windows\inf\OEM1.inf.
Llame a la función setupGetInfDriverStoreLocation para recuperar el nombre de archivo completo de un archivo INF en el almacén de controladores que corresponde a un archivo INF especificado en el directorio de archivos INF del sistema o un archivo especificado en el almacén de controladores.
Nota
El encabezado setupapi.h define SetupGetInfPublishedName como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Disponible en Windows Vista y versiones posteriores de Windows. |
| de la plataforma de destino de |
Escritorio |
| encabezado de |
setupapi.h (incluya Setupapi.h) |
| biblioteca de |
Setupapi.lib |