UrlIsA 関数 (shlwapi.h)

URL が指定された型であるかどうかをテストします。

構文

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

パラメーター

[in] pszUrl

種類: PCTSTR

URL を含む最大長INTERNET_MAX_URL_LENGTHの null で終わる文字列。

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 の種類の 1 つを含むすべてについて、 URL が 指定された型の場合は TRUE 、指定されていない場合は FALSE が 返されます。

UrlIs がURLIS_APPLIABLE に設定されている場合、UrlIs は URL スキームの決定を試みます。 関数がスキームを決定できる場合は TRUE を返し、それ以外の場合 は FALSE を 返します。

注釈

注意

shlwapi.h ヘッダーは、URLI をエイリアスとして定義します。このエイリアスは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択します。 エンコードに依存しないエイリアスをエンコードニュートラルでないコードと組み合わせて使用すると、コンパイルまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。

要件

要件	値
サポートされている最小のクライアント	Windows 2000 Professional、Windows XP [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム	Windows
ヘッダー	shlwapi.h
Library	Shlwapi.lib
[DLL]	Shlwapi.dll (バージョン 5.0 以降)

こちらもご覧ください

UrlIsFileUrl

UrlIsNoHistory

UrlIsOpaque