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
인터넷 프로토콜 체계. 이 멤버는 다음 값 중 하나일 수 있습니다.
| 값 | 의미 |
|---|---|
|
인터넷 구성표는 HTTP 프로토콜입니다. 자세한 내용은 RFC 2616 을 참조하세요. |
|
인터넷 스키마 HTTPS는 보안 트랜잭션 의미 체계를 사용하는 HTTP 프로토콜입니다. |
lpszHostName
호스트 이름을 포함하는 문자열 값에 대한 포인터입니다.
dwHostNameLength
호스트 이름의 길이(문자)입니다.
nPort
포트 번호입니다.
lpszUserName
사용자 이름을 포함하는 문자열에 대한 포인터입니다.
dwUserNameLength
사용자 이름의 길이(문자)입니다.
lpszPassword
암호를 포함하는 문자열에 대한 포인터입니다.
dwPasswordLength
암호의 길이(문자)입니다.
lpszUrlPath
URL 경로가 포함된 문자열에 대한 포인터입니다.
dwUrlPathLength
URL 경로의 길이(문자)입니다.
lpszExtraInfo
추가 정보가 포함된 문자열 값(예: ?something 또는 #something)에 대한 포인터입니다.
dwExtraInfoLength
추가 정보의 길이를 문자로 포함하는 부호 없는 긴 정수 값입니다.
설명
WinHttpCrackUrl 함수의 경우 포인터 멤버와 해당 길이 멤버가 모두 0이면 URL의 해당 구성 요소가 반환되지 않습니다. 포인터 멤버가 NULL 이지만 길이 멤버가 0이 아닌 경우 포인터와 길이 멤버가 모두 반환됩니다. 포인터와 해당 길이 멤버가 모두 0이 아닌 경우 포인터 멤버는 구성 요소가 복사되는 버퍼를 가리킵니다. WinHttpCrackUrl의 dwFlags 매개 변수에 따라 모든 이스케이프 시퀀스를 구성 요소에서 제거할 수 있습니다.
WinHttpCreateUrl 함수의 경우 URL의 구성 요소가 필요하지 않은 경우 포인터 멤버는 NULL이어야 합니다. 해당 길이 멤버가 0이면 포인터 멤버는 0으로 끝나는 문자열에 대한 포인터입니다. length 멤버가 0이 아닌 경우 해당 포인터 멤버의 문자열 길이입니다.
요구 사항
| 지원되는 최소 클라이언트 | Windows XP, Windows 2000 Professional SP3 [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2003, Windows 2000 Server SP3 [데스크톱 앱만 해당] |
| 머리글 | winhttp.h |
| 재배포 가능 파일 | Windows XP 및 Windows 2000에서 WinHTTP 5.0 및 인터넷 Explorer 5.01 이상. |