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.h ヘッダーは、unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとしてURL_COMPONENTSを定義します。 encoding-neutral エイリアスの使用を encoding-neutral ではないコードと混在すると、コンパイル エラーまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
Header | wininet.h |