SHValidateUNC 函式 (shlobj_core.h)

[SHValidateUNC 可用於需求一節中指定的操作系統。它可能會在後續版本中改變或無法使用。]

呼叫 WNetAddConnection3，以驗證 UNC) 路徑 (通用命名慣例。函式可讓使用者從 [開始] 選單上的 [執行] 對話框輸入遠端網路存取 (RNA) UNC 應用程式或檔案名稱。

語法

BOOL SHValidateUNC(
  [in, optional] HWND  hwndOwner,
  [in, out]      PWSTR pszFile,
                 UINT  fConnect
);

[in, optional] hwndOwner

類型： HWND

用來顯示 UI 之父視窗的句柄。如果不需要這個值，這個值可以設定為 NULL。

[in, out] pszFile

類型： PWSTR

指定要驗證之 UNC 路徑之 Null 終止 Unicode 字串的指標。注意：此字串不得為常數位符串。

fConnect

類型： UINT

下列一或多個值。

連接驅動器號。設定此旗標時， pszFile 中的值會變更為 UNC 在本機電腦上對應的本機磁碟驅動器。

在失敗或成功時，不會顯示任何UI。

驗證為列印共用，而不是磁碟共用。

Windows Vista 和更新版本。應該持續連線。

用來驗證傳遞至 SHValidateUNC 之旗標的遮罩值是否有效。

類型： BOOL

如果 UNC 路徑存在，則傳回 TRUE ;如果 UNC 路徑不存在或發生其他失敗，則為 FALSE 。