Assembly: Microsoft.VisualStudio.Shell.Interop (in microsoft.visualstudio.shell.interop.dll)
int QuerySaveFile ( [InAttribute] string pszMkDocument, [InAttribute] uint rgf, [InAttribute] VSQEQS_FILE_ATTRIBUTE_DATA pFileInfo, out uint pdwQSResult )
int QuerySaveFile ( /** @attribute InAttribute() */ String pszMkDocument, /** @attribute InAttribute() */ UInt32 rgf, /** @attribute InAttribute() */ VSQEQS_FILE_ATTRIBUTE_DATA pFileInfo, /** @attribute OutAttribute() */ /** @ref */ UInt32 pdwQSResult )
[in] Path to the file (document to be saved) on the disk.
[in] Flags whose values for valid file attributes are taken from theenumeration. The default value is zero.
[in] Values taken from the rgf is 0.structure containing information about the file attributes. Can be a null reference (Nothing in Visual Basic);is ignored if
[out] Pointer to a value taken from theenumeration.
Return ValueIf the method fails, it returns an error code. If it succeeds, it returns:
Save the file. The file should not be read-only at this point.
QuerySaveFile has not put up a Save As dialog box, but either it is quietly telling you to do so, or the user has been prompted and has selected Save As. If you are editing a conventional file, you are encouraged to call themethod in the interface at this point.
The user was notified that the file is read-only and has elected either to not save or to cancel the operation. The choice depends on the/ methods.
Proceed with save (QSR_SaveOK).
Do not save ().
Save as (QSR_ForceSaveAs).
Cancel Save (QSR_NoSave_UserCanceled or).
HRESULT QuerySaveFile( [in] LPCOLESTR pszMkDocument, [in] VSQEQSFlags rgf, [in] const VSQEQS_FILE_ATTRIBUTE_DATA *pFileInfo, [out, retval] VSQuerySaveResult *pdwQSResult );
Before a project or editor saves a file, it must call this method or themethod. For project files, these calls are completed automatically by the solution, which knows when to save a project file. Editors are responsible for making these calls unless the editor implementation of uses the helper function method. If your editor implements IVsPersistDocData2 in this way, then the call to QuerySaveFile or QuerySaveFiles is made for you.
Call this method before saving anything to disk. It will handle read-only and checked-in files in a uniform, shared way.
This method may need to issue a checkout command to ensure that the file is writable (for example, if the file was edited in memory). For a source control package that provides for the “checkout local version” option, this is a safe operation. For a source control package that does not, the checkout operation cannot be completed without data loss. In this case, Save As is the only option.