次の方法で共有

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 でない場合は、ポインターメンバーと長さメンバーの両方が返されます。 ポインターと対応する長さのメンバーの両方が 0 以外の場合、ポインター メンバーは、コンポーネントがコピーされるバッファーを指します。 コンポーネントは、internetCrackUrlの dwFlags パラメーター 応じてエスケープ解除できます。

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

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

手記

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

必要条件

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

関連項目

InternetCrackUrl

InternetCreateUrl