![]() |
(SST) ShlWAPI.pas Version 1.08 |
---|---|
Developer Reference |
Adds quotation marks to both ends of a string if this contains blanks/spaces. |
Scope |
---|
Global (i.e. this function can be called/accessed from code in any unit that includes/uses (SST)ShlWAPI.pas). |
Parameters | |
---|---|
lpsz [in/out] | Depending on which version of the function is called, a pointer to the buffer containing either the ANSI or Unicode string to be modified. |
Return Values |
---|
Returns TRUE if quotation marks were added to the string, FALSE, if not (but see remarks, below). |
Remarks |
---|
Up to, and including MS SDK version 6.0, this function was declared and documented as a procedure (i.e. as a function that does not return a value to the caller directly, commonly thru/via a CPU register). In version 6.1 of the MS SDK however, it is declared and documented as a function returning a BOOL value. This suggests that either, there was an error in the previous declaration, or that the function underwent substantial modifications. |
Example |
---|
PROCEDURE TForm4.TestShlWAPIPathQuoteSpaces(Sender : TObject); VAR pathbuf : ARRAY[0..MAX_PATH] OF CHAR; VAR apiretval : BOOL; VAR newinfoline : STRING; BEGIN FillChar(pathbuf, Length(pathbuf), #0); apiretval := FALSE; newinfoline := ''; pathbuf := 'C:\Hello World !'; newinfoline := 'PathQuoteSpaces called with ' + pathbuf; Memo1.Lines.Add(newinfoline); apiretval := PathQuoteSpaces(pathbuf); IF apiretval THEN newinfoline := 'TRUE ' + pathbuf ELSE newinfoline := 'FALSE'; Memo1.Lines.Add(newinfoline); pathbuf := 'C:\Hello\World'; newinfoline := 'PathQuoteSpaces called with ' + pathbuf; Memo1.Lines.Add(newinfoline); apiretval := PathQuoteSpaces(pathbuf); IF apiretval THEN newinfoline := 'TRUE ' + pathbuf ELSE newinfoline := 'FALSE'; Memo1.Lines.Add(newinfoline); Memo1.Lines.Add(''); pathbuf := 'C:\Program Files\Windows Mail\wab.exe -DummyParam /a "DummyParam2"'; newinfoline := 'PathQuoteSpaces called with ' + pathbuf; Memo1.Lines.Add(newinfoline); apiretval := PathQuoteSpaces(pathbuf); IF apiretval THEN newinfoline := 'TRUE ' + pathbuf ELSE newinfoline := 'FALSE'; Memo1.Lines.Add(newinfoline); END; |
The above example produces the following output: |
PathQuoteSpaces called with C:\Hello World ! TRUE "C:\Hello World !" PathQuoteSpaces called with C:\Hello\World FALSE PathQuoteSpaces called with C:\Program Files\Windows Mail\wab.exe -DummyParam /a "DummyParam2" TRUE "C:\Program Files\Windows Mail\wab.exe -DummyParam /a "DummyParam2"" |
Requirements | |
---|---|
Unit: | Declared and imported in (SST)ShlWAPI.pas |
Library: | (SST)ShlWAPI.dcu/(SST)ShlWAPI.obj |
Unicode: | Implemented as ANSI (PathQuoteSpaces and PathQuoteSpacesA) and Unicode (PathQuoteSpacesW) functions. |
Min. ShlWAPI.dll version according to MS SDK doc.: | 4.71 |
Min. ShlWAPI.dll version based on SST research: | 4.71 |
Min. OS version(s) according to Microsoft SDK doc.: | Windows 2000, Windows NT 4.0 with Internet Explorer 4.0, Windows 98, Windows 95 with Internet Explorer 4.0. |
Min. OS version(s) according to SST research.: | Windows NT 4.0 with IE 4.0, Windows 95 with IE 4.0, Windows 98, Windows 2000 and later. |
See Also |
---|
PathRemoveArgs, PathGetArgs, PathUnquoteSpaces. |
Windows APIs: PathQuoteSpaces, PathUnquoteSpaces. |
Document/Contents version 1.00 Page/URI last updated on May 04, 2022 |
Copyright © Stoelzel Software Technologie (SST) 2010 - 2017 |
Suggestions and comments mail to: webmaster@stoelzelsoftwaretech.com |