如何在C#中使用Win32和其他庫之二

簡單字串

下面是一個接受字串參數的函數的簡單樣本：

BOOL GetDiskFreeSpace(  LPCTSTR lpRootPathName,          // 根路徑  LPDWORD lpSectorsPerCluster,     // 每個簇的扇區數  LPDWORD lpBytesPerSector,        // 每個扇區的位元組數  LPDWORD lpNumberOfFreeClusters,  // 可用的扇區數  LPDWORD lpTotalNumberOfClusters  // 扇區總數);

根路徑定義為 LPCTSTR。這是獨立於平台的字串指標。

由於不存在名為 GetDiskFreeSpace() 的函數，封送拆收器將自動尋找“A”或“W”變體，並調用相應的函數。我們使用一個屬性來告訴封送拆收器，API
所要求的字串類型。

以下是該函數的完整定義，就象我開始定義的那樣：

[DllImport("kernel32.dll")]static extern bool GetDiskFreeSpace(   [MarshalAs(UnmanagedType.LPTStr)]   string rootPathName,   ref int sectorsPerCluster,   ref int bytesPerSector,   ref int numberOfFreeClusters,   ref int totalNumberOfClusters);

不幸的是，當我試圖運行時，該函數不能執行。問題在於，無論我們在哪個平台上，封送拆收器在預設情況下都試圖尋找 API 的 Ansi 版本，由於
LPTStr 意味著在
Windows NT 平台上會使用 Unicode 字串，因此試圖用 Unicode 字串來調用 Ansi 函數就會失敗。

有兩種方法可以解決這個問題：一種簡單的方法是刪除 MarshalAs 屬性。如果這樣做，將始終調用該函數的
A 版本，如果在您所涉及的所有平台上都有這種版本，這是個很好的方法。但是，這會降低代碼的執行速度，因為封送拆收器要將 .NET 字串從 Unicode 轉換為多位元組，然後調用函數的
A 版本（將字串轉換回 Unicode），最後調用函數的
W 版本。

要避免出現這種情況，您需要告訴封送拆收器，要它在 Win9x 平台上時尋找 A 版本，而在 NT 平台上時尋找 W 版本。要實現這一目的，可以將
CharSet 設定為
DllImport 屬性的一部分：

[DllImport("kernel32.dll", CharSet = CharSet.Auto)]

在我的非正式計時測試中，我發現這一做法比前一種方法快了大約百分之五。

對於大多數 Win32 API，都可以對字串類型設定 CharSet 屬性並使用
LPTStr。但是，還有一些不採用
A/W 機制的函數，對於這些函數必須採取不同的方法。

字串緩衝區

.NET 中的字串類型是不可改變的類型，這意味著它的值將永遠保持不變。對於要將字串值複製到字串緩衝區的函數，字串將無效。這樣做至少會破壞由封送拆收器在轉換字串時建立的臨時緩衝區；嚴重時會破壞託管堆，而這通常會導致錯誤的發生。無論哪種情況都不可能獲得正確的傳回值。

要解決此問題，我們需要使用其他類型。StringBuilder 類型就是被設計為用作緩衝區的，我們將使用它來代替字串。下面是一個樣本：

[DllImport("kernel32.dll", CharSet = CharSet.Auto)]public static extern int GetShortPathName(   [MarshalAs(UnmanagedType.LPTStr)]   string path,   [MarshalAs(UnmanagedType.LPTStr)]   StringBuilder shortPath,   int shortPathLength);

使用此函數很簡單：

StringBuilder shortPath = new StringBuilder(80);int result = GetShortPathName(@"d:est.jpg", shortPath, shortPath.Capacity);string s = shortPath.ToString();

請注意，StringBuilder 的
Capacity 傳遞的是緩衝區大小。