Editing findClose - FilterMeisterWiki

When saving, enter the following:

  ______  TT  TT    __  __ ZZZZ ZZZ  TT  TT  
 |  ____| TT  TT   |  \/  | ZZ   Z   TT  TT  
 | |__    TT  TT   | |\/| | ZZ   Z    TTTT   
 |  __|    TTTT    | |  | | ZZ   Z     TT    
 | |        TT     |_|  |_| ZZ   Z    TTTT   
 |_|        TT              ZZ   Z   TT  TT  
            TT               ZZZZ    TT  TT

Visit Preferences to set your user name

= findClose =

== Syntax ==
{{int findClose(int *searchHandle)}}

== Arguments ==
:'''searchHandle'''
::A search handle from a previous call to findFirstFile / findNextFile.

== Return ==
Returns 0 if the function failed, or non-zero if the function succeeded.

== Description ==
Closes a file search handle opened with ((findFirstFile)).

== Comment ==
Internally, findClose is a simple wrapper around the built-in Windows [https://docs.microsoft.com/en-us/windows/win32/api/fileapi/nf-fileapi-findclose Win32 FindClose API] function.

== Example ==
<code>
%ffp

OnFilterStart: {

int Handle, Attribute;

// Search for 8bf files in the filterInstallDir
  snprintf(str1, 255, "%s\\*.8bf", filterInstallDir);

// Optionally, search the C: root instead
  //strcpy(str1,"C:\\");

Handle = findFirstFile (str1, str9, &Attribute);
  if (Attribute != FILE_ATTRIBUTE_DIRECTORY) 
    Info ("%s - %d",str9, Attribute);
     
  if (Handle != INVALID_HANDLE_VALUE){
    while (findNextFile(Handle, str9, &Attribute) != 0) { 
      if (Attribute != FILE_ATTRIBUTE_DIRECTORY) 
        Info ("%s - %d",str9, Attribute);
    }
  }

findClose(Handle);

return false;
}
</code>

== See Also ==
((findFirstFile)), ((findNextFile))

Summary of change:
Add document to category: