URL_COMPONENTSA 結構 (wininet.h)
包含 URL 的組成部分。 這個結構會與 InternetCrackUrl 和 InternetCreateUrl 函式搭配使用。
語法
typedef struct {
DWORD dwStructSize;
LPSTR lpszScheme;
DWORD dwSchemeLength;
INTERNET_SCHEME nScheme;
LPSTR lpszHostName;
DWORD dwHostNameLength;
INTERNET_PORT nPort;
LPSTR lpszUserName;
DWORD dwUserNameLength;
LPSTR lpszPassword;
DWORD dwPasswordLength;
LPSTR lpszUrlPath;
DWORD dwUrlPathLength;
LPSTR lpszExtraInfo;
DWORD dwExtraInfoLength;
} URL_COMPONENTSA, *LPURL_COMPONENTSA;
成員
dwStructSize
這個結構的大小,以位元組為單位。
lpszScheme
包含配置名稱的字串指標。
dwSchemeLength
配置名稱的大小,以 TCHAR 為單位。
nScheme
INTERNET_SCHEME 值,表示因特網通訊協定配置。
lpszHostName
包含主機名的字串指標。
dwHostNameLength
主機名的大小,以 TCHAR 為單位。
nPort
已轉換的埠號碼。
lpszUserName
包含用戶名稱的字串值指標。
dwUserNameLength
TCHAR 中用戶名稱的大小。
lpszPassword
包含密碼的字串指標。
dwPasswordLength
密碼的大小,以 TCHAR 為單位。
lpszUrlPath
包含 URL 路徑的字串指標。
dwUrlPathLength
URL 路徑的大小,以 TCHAR 為單位。
lpszExtraInfo
字串的指標,其中包含額外資訊 (例如?某專案或 #something) 。
dwExtraInfoLength
TCHAR 中額外資訊的大小。
備註
若為 InternetCrackUrl,如果指標成員及其對應的長度成員都是零,則不會傳回該元件。 如果指標成員為 NULL ,但長度成員不是零,則會傳回指標和長度成員。 如果指標和對應的長度成員都是非零的,則指標成員會指向複製元件所在的緩衝區。 根據 InternetCrackUrl 的 dwFlags 參數而定,元件可以解除逸出。
若為 InternetCreateUrl,如果不需要元件,指標成員應為 NULL 。 如果對應的長度成員為零,則指標成員是零終止字串的位址。 如果長度成員不是零,則它是對應指標成員的字串長度。
注意
wininet.h 標頭會將URL_COMPONENTS定義為別名,根據 UNICODE 預處理器常數的定義,自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼,可能會導致編譯或運行時間錯誤不符。 如需詳細資訊,請參閱 函式原型的慣例。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 2000 專業版 [僅限傳統型應用程式] |
最低支援的伺服器 | Windows 2000 Server [僅限傳統型應用程式] |
標頭 | wininet.h |