DavGetHTTPFromUNCPath 函式 (davclnt.h)
將指定的 UNC 路徑轉換為相等的 HTTP 路徑。
語法
DWORD DavGetHTTPFromUNCPath(
[in] LPCWSTR UncPath,
[out] LPWSTR Url,
[in, out] LPDWORD lpSize
);
參數
[in] UncPath
包含 UNC 路徑之 Null 終止 Unicode 字串的指標。 這個路徑的格式必須如下:
\\server[@SSL][@port][\path]
where
- 伺服器 是伺服器名稱。
- @SSL是選擇性的,並指出 SSL 連線的要求。
- port 是選擇性的埠號碼。 標準埠為 HTTP 為 80,https (SSL) 則為 443。
- path 是選擇性的,並指定伺服器上的遠端檔案或目錄的路徑。
[out] Url
呼叫端配置的緩衝區指標,以 Null 終止的 Unicode 字串的形式接收 HTTP 路徑。
[in, out] lpSize
輸入上變數的指標會指定 HttpPath 參數指向之緩衝區的大小上限 Unicode 字元。 如果函式成功,在輸出時,變數會收到複製到緩衝區中的字元數。 如果函式因ERROR_INSUFFICIENT_BUFFER而失敗,則變數在輸出上會收到儲存 HTTP 路徑所需的字元數,包括 「http://」 或 「https://」 前置詞和終止 NULL 字元。
傳回值
如果函式成功,傳回值會ERROR_SUCCESS。
如果函式失敗,則傳回值是 系統錯誤碼,例如下列值。
傳回碼 | Description |
---|---|
|
HttpPath 參數指向的緩衝區不夠大,無法儲存 HTTP 路徑。 |
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows Vista [僅限傳統型應用程式] |
最低支援的伺服器 | Windows Server 2008 [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | davclnt.h |
程式庫 | Netapi32.lib |
Dll | Netapi32.dll |