URL_COMPONENTSW構造体 (wininet.h)

  • [アーティクル]

URL の構成要素を格納します。 この構造体は、 InternetCrackUrl 関数と InternetCreateUrl 関数で使用されます。

構文

typedef struct {
  DWORD           dwStructSize;
  LPWSTR          lpszScheme;
  DWORD           dwSchemeLength;
  INTERNET_SCHEME nScheme;
  LPWSTR          lpszHostName;
  DWORD           dwHostNameLength;
  INTERNET_PORT   nPort;
  LPWSTR          lpszUserName;
  DWORD           dwUserNameLength;
  LPWSTR          lpszPassword;
  DWORD           dwPasswordLength;
  LPWSTR          lpszUrlPath;
  DWORD           dwUrlPathLength;
  LPWSTR          lpszExtraInfo;
  DWORD           dwExtraInfoLength;
} URL_COMPONENTSW, *LPURL_COMPONENTSW;

メンバー

dwStructSize

この構造体のサイズ (バイト単位)。

lpszScheme

スキーム名を含む文字列へのポインター。

dwSchemeLength

スキーム名のサイズ (TCHAR)。

nScheme

INTERNET_SCHEME インターネット プロトコル スキームを示す値です。

lpszHostName

ホスト名を含む文字列へのポインター。

dwHostNameLength

ホスト名のサイズ (TCHAR)。

nPort

変換されたポート番号。

lpszUserName

ユーザー名を含む文字列値へのポインター。

dwUserNameLength

TCHAR でのユーザー名のサイズ。

lpszPassword

パスワードを含む文字列へのポインター。

dwPasswordLength

パスワードのサイズ (TCHAR)。

lpszUrlPath

URL パスを含む文字列へのポインター。

dwUrlPathLength

URL パスのサイズ (TCHAR)。

lpszExtraInfo

追加情報 (?something や #something など) を含む文字列へのポインター。

dwExtraInfoLength

TCHAR での追加情報のサイズ。

注釈

InternetCrackUrl の場合、ポインター メンバーとそれに対応する長さメンバーの両方が 0 の場合、そのコンポーネントは返されません。 ポインター メンバーが NULL で、長さメンバーが 0 でない場合は、ポインターメンバーと長さメンバーの両方が返されます。 ポインターと対応する長さのメンバーの両方が 0 以外の場合、ポインター メンバーは、コンポーネントがコピーされるバッファーを指します。 コンポーネントは、InternetCrackUrl の dwFlags パラメーターに応じてエスケープ解除できます。

InternetCreateUrl の場合、コンポーネントが必要ない場合、ポインター メンバーは NULL である必要があります。 対応する長さメンバーが 0 の場合、ポインター メンバーは 0 で終わる文字列のアドレスです。 長さメンバーが 0 でない場合は、対応するポインター メンバーの文字列の長さになります。

メモ WinINet では、サーバーの実装はサポートされていません。 また、サービスから使用しないでください。 サーバーの実装またはサービスの場合は、 Microsoft Windows HTTP サービス (WinHTTP) を使用します。
 

注意

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

要件

要件 値
サポートされている最小のクライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリのみ]
Header wininet.h

こちらもご覧ください

InternetCrackUrl

InternetCreateUrl