Add opt-in DFS client support with referral resolution

.gitignore

@@ -229,3 +229,4 @@ $RECYCLE.BIN/
 
 # Windows shortcuts
 *.lnk
+.windsurf/

ClientExamples.md

@@ -34,6 +34,30 @@ if (status == NTStatus.STATUS_SUCCESS)
 status = fileStore.Disconnect();
 ```
 
+Enable DFS support on a file store:
+===================================
+```cs
+ISMBFileStore fileStore = client.TreeConnect("Shared", out status);
+if (status == NTStatus.STATUS_SUCCESS)
+{
+    // Wrap with DFS support (disabled by default)
+    DfsClientOptions options = new DfsClientOptions { Enabled = true };
+    ISMBFileStore dfsStore = DfsClientFactory.CreateDfsAwareFileStore(fileStore, null, options);
+
+    // Use dfsStore normally - DFS paths are resolved automatically
+    object directoryHandle;
+    FileStatus fileStatus;
+    status = dfsStore.CreateFile(out directoryHandle, out fileStatus, @"\DfsLink\Subfolder", AccessMask.GENERIC_READ, FileAttributes.Directory, ShareAccess.Read | ShareAccess.Write, CreateDisposition.FILE_OPEN, CreateOptions.FILE_DIRECTORY_FILE, null);
+    if (status == NTStatus.STATUS_SUCCESS)
+    {
+        List<QueryDirectoryFileInformation> fileList;
+        status = dfsStore.QueryDirectory(out fileList, directoryHandle, "*", FileInformationClass.FileDirectoryInformation);
+        status = dfsStore.CloseFile(directoryHandle);
+    }
+}
+status = fileStore.Disconnect();
+```
+
 Connect to share and list files and directories - SMB2:
 =======================================================
 ```cs

Readme.md

@@ -57,6 +57,10 @@ You can share anything from actual directories to custom objects, as long as the
 
 Client code examples can be found [here](ClientExamples.md).
 
+DFS Client Support:
+===================
+SMBLibrary provides opt-in DFS (Distributed File System) client support. Wrap any `ISMBFileStore` with `DfsClientFactory.CreateDfsAwareFileStore()` to enable automatic DFS path resolution. See [ClientExamples.md](ClientExamples.md) for usage.
+
 NuGet Packages:
 ===============
 [SMBLibrary](https://www.nuget.org/packages/SMBLibrary/) - Cross-platform server and client implementation.