DavGetUNCFromHTTPPath 函式 (davclnt.h)
將指定的 HTTP 路徑轉換為對等的 UNC 路徑。
語法
DWORD DavGetUNCFromHTTPPath(
[in] LPCWSTR Url,
[out] LPWSTR UncPath,
[in, out] LPDWORD lpSize
);
參數
[in] Url
包含 HTTP 路徑之 Null終止 Unicode 字串的指標。 此字串可以是下列任何格式,其中 伺服器 是伺服器名稱和 路徑 是伺服器上的遠端檔案或目錄的路徑:
- HTTP://伺服器/路徑
- HTTP://伺服器
- \\HTTP:// server/路徑
- \\HTTP:// server
- HTTPs://伺服器/路徑
- HTTPs:// server
- \\HTTPs:// server/路徑
- \\HTTPs:// server
- \\server\path
- \\server
[out] UncPath
呼叫端配置的緩衝區指標,接收 UNC 路徑做為 Null終止的 Unicode 字串。
[in, out] lpSize
輸入上變數的指標會指定 UncPath 參數指向之緩衝區的大小上限 Unicode 字元。 如果函式成功,在輸出時,變數會收到複製到緩衝區的字元數,包括終止 的 Null 字元。 如果函式因ERROR_INSUFFICIENT_BUFFER而失敗,則變數在輸出上會收到儲存 UNC 路徑所需的字元數,包括終止 的 Null 字元。
傳回值
如果函式成功,傳回值會ERROR_SUCCESS。
如果函式失敗,則傳回值是 系統錯誤碼,例如下列值。
傳回碼 | 描述 |
---|---|
|
UncPath參數指向的緩衝區不夠大,無法儲存 UNC 路徑。 |
需求
最低支援的用戶端 | Windows Vista [僅限傳統型應用程式] |
最低支援的伺服器 | Windows Server 2008 [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | davclnt.h |
程式庫 | Netapi32.lib |
Dll | Netapi32.dll |