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