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 や #something など) を含む文字列へのポインター。

dwExtraInfoLength

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

注釈

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

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

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

注意

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

要件

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

こちらもご覧ください

InternetCrackUrl

InternetCreateUrl