UID | title | description | helpviewer_keywords | old-location | tech.root | ms.assetid | ms.date | ms.keywords | req.header | req.include-header | req.target-type | req.target-min-winverclnt | req.target-min-winversvr | req.kmdf-ver | req.umdf-ver | req.ddi-compliance | req.unicode-ansi | req.idl | req.max-support | req.namespace | req.assembly | req.type-library | req.lib | req.dll | req.irql | targetos | req.typenames | req.redist | ms.custom | f1_keywords | dev_langs | topic_type | api_type | api_location | api_name | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
NF:setupapi.SetupQueueRenameA |
SetupQueueRenameA function (setupapi.h) |
The SetupQueueRename function places an individual file rename operation on a setup file queue. (ANSI) |
|
setup\setupqueuerename.htm |
setup |
0b80eba9-9e71-4255-8c1b-039878682ec4 |
12/05/2018 |
SetupQueueRename, SetupQueueRename function [Setup API], SetupQueueRenameA, SetupQueueRenameW, _setupapi_setupqueuerename, setup.setupqueuerename, setupapi/SetupQueueRename, setupapi/SetupQueueRenameA, setupapi/SetupQueueRenameW |
setupapi.h |
Windows |
Windows XP [desktop apps only] |
Windows Server 2003 [desktop apps only] |
SetupQueueRenameW (Unicode) and SetupQueueRenameA (ANSI) |
Setupapi.lib |
Setupapi.dll |
Windows |
19H1 |
|
|
|
|
|
|
[This function is available for use in the operating systems indicated in the Requirements section. It may be altered or unavailable in subsequent versions. SetupAPI should no longer be used for installing applications. Instead, use the Windows Installer for developing application installers. SetupAPI continues to be used for installing device drivers.]
The SetupQueueRename function places an individual file rename operation on a setup file queue.
Handle to a setup file queue, as returned by SetupOpenFileQueue.
Pointer to a null-terminated string that specifies the source path of the file to be renamed. If SourceFileName is not specified, SourcePath is assumed to be the full path.
Pointer to a null-terminated string that specifies the file name part of the file to be renamed. If not specified, SourcePath is the full path.
Pointer to a null-terminated string that specifies the target directory. When this parameter is specified, the rename operation is actually a move operation. If TargetPath is not specified, the file is renamed but remains in its current location.
Pointer to a null-terminated string that specifies the new name for the source file.
If the function succeeds, the return value is a nonzero value.
If the function fails, the return value is zero. To get extended error information, call GetLastError.
Because rename operations are assumed to take place on fixed media, the user will not be prompted when the queue is committed.
Note
The setupapi.h header defines SetupQueueRename as an alias which automatically selects the ANSI or Unicode version of this function based on the definition of the UNICODE preprocessor constant. Mixing usage of the encoding-neutral alias with code that not encoding-neutral can lead to mismatches that result in compilation or runtime errors. For more information, see Conventions for Function Prototypes.