次の方法で共有

URL_COMPONENTS 構造体 (winhttp.h)

  • [アーティクル]

URL_COMPONENTS構造体には、URL の構成要素が含まれています。 この構造体は、 WinHttpCrackUrl 関数と WinHttpCreateUrl 関数で使用されます。

構文

typedef struct _WINHTTP_URL_COMPONENTS {
  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_COMPONENTS, *LPURL_COMPONENTS;

メンバー

dwStructSize

この構造体のサイズ (バイト単位)。 バージョン チェックに使用されます。 この構造体を適切に初期化するには、この構造体のサイズを設定する必要があります。

lpszScheme

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

dwSchemeLength

スキーム名の長さ (文字数)。

nScheme

インターネット プロトコル スキーム。 このメンバーには、次のいずれかの値を指定できます。

値 説明
INTERNET_SCHEME_HTTP
1
 インターネット スキームは HTTP プロトコルです。 詳細については 、RFC 2616 を参照してください。
INTERNET_SCHEME_HTTPS
2
 インターネット スキーム HTTPS は、セキュリティで保護されたトランザクション セマンティクスを使用する HTTP プロトコルです。

lpszHostName

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

dwHostNameLength

ホスト名の長さ (文字数)。

nPort

ポート番号。

lpszUserName

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

dwUserNameLength

ユーザー名の長さ (文字数)。

lpszPassword

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

dwPasswordLength

パスワードの長さ (文字数)。

lpszUrlPath

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

dwUrlPathLength

URL パスの長さ (文字数)。

lpszExtraInfo

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

dwExtraInfoLength

追加情報の長さを含む符号なし long 整数値 (文字数)。

解説

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

WinHttpCreateUrl 関数の場合、URL のコンポーネントが必要ない場合は、ポインター メンバーを NULL にする必要があります。 対応する長さメンバーが 0 の場合、ポインター メンバーは 0 で終わる文字列へのポインターです。 長さメンバーが 0 でない場合は、対応するポインター メンバーの文字列の長さになります。

メモ Windows XP と Windows 2000 については、WinHttp スタート ページの 「ランタイム要件 」セクションを参照してください。
 

要件

   
サポートされている最小のクライアント Windows XP、Windows 2000 Professional SP3 [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2003、Windows 2000 Server SP3 [デスクトップ アプリのみ]
Header winhttp.h
再頒布可能パッケージ Windows XP および Windows 2000 では、WinHTTP 5.0 およびインターネット エクスプローラー 5.01 以降がインストールされています。

関連項目

WinHTTP バージョン