UrlIsA 函式 (shlwapi.h)

測試 URL 是否為指定的類型。

語法

BOOL UrlIsA(
  [in] PCSTR pszUrl,
       URLIS UrlIs
);

參數

[in] pszUrl

類型: PCTSTR

長度上限為 null 的字串,INTERNET_MAX_URL_LENGTH包含 URL。

UrlIs

類型: URLIS

要測試的 URL 類型。 此參數可以採用下列其中一個值。

URLIS_APPLIABLE

嘗試判斷URL的有效配置。

URLIS_DIRECTORY

URL 字串是否以目錄結尾?

URLIS_FILEURL

URL 是否為檔案 URL?

URLIS_HASQUERY

URL 是否有附加的查詢字串?

URLIS_NOHISTORY

URL 是否為通常未在瀏覽歷程記錄中追蹤的 URL?

URLIS_OPAQUE

URL 是否 不透明

URLIS_URL

URL 是否有效?

傳回值

類型: BOOL

對於其中一個 URL 類型,如果 URL 是指定的類型, 則 URLIs 會 傳回 TRUE ,否則傳回 FALSE

如果 URLIs 設定為 URLIS_APPLIABLE則 URLIs 會嘗試判斷 URL 配置。 如果函式能夠判斷配置,則會傳回 TRUE 或 FALSE。否則會傳回 FALSE

備註

注意

shlwapi.h 標頭會將 URL 定義為別名,根據 UNICODE 預處理器常數的定義,自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼,可能會導致編譯或運行時間錯誤不符。 如需詳細資訊,請參閱 函式原型的慣例

規格需求

需求
最低支援的用戶端 Windows 2000 專業版、Windows XP [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限傳統型應用程式]
目標平台 Windows
標頭 shlwapi.h
程式庫 Shlwapi.lib
Dll Shlwapi.dll (5.0 版或更新版本)

另請參閱

UrlIsFileUrl

UrlIsNoHistory

UrlIsOpaque