ATL HTTP 유틸리티 함수

이러한 함수는 URL 조작을 지원합니다.

함수	설명
AtlCanonicalizeUrl	안전하지 않은 문자와 공백을 이스케이프 시퀀스로 변환하는 것을 포함하는 URL을 정식화합니다.
AtlCombineUrl	기본 URL과 상대 URL을 하나의 정식 URL로 결합합니다.
AtlEscapeUrl	안전하지 않은 모든 문자를 이스케이프 시퀀스로 변환합니다.
AtlGetDefaultUrlPort	특정 인터넷 프로토콜 또는 스키마와 연결된 기본 포트 번호를 가져옵니다.
AtlIsUnsafeUrlChar	문자가 URL에서 사용하기에 안전한지 여부를 결정합니다.
AtlUnescapeUrl	이스케이프된 문자를 원래 값으로 다시 변환합니다.
RGBToHtml	COLORREF 값을 해당 색 값에 해당하는 HTML 텍스트로 변환합니다.
SystemTimeToHttpDate	시스템 시간을 HTTP 헤더에서 사용하기에 적합한 형식의 문자열로 변환하려면 이 함수를 호출합니다.

요구 사항

헤더: atlutil.h

AtlCanonicalizeUrl

안전하지 않은 문자와 공백을 이스케이프 시퀀스로 변환하는 등 URL을 정식화하려면 이 함수를 호출합니다.

inline BOOL AtlCanonicalizeUrl(
   LPCTSTR szUrl,
   LPTSTR szCanonicalized,
   DWORD* pdwMaxLength,
   DWORD dwFlags = 0) throw();

매개 변수

szUrl
정식화할 URL입니다.

szCanonicalized
정식화된 URL을 수신하기 위해 호출자가 할당한 버퍼입니다.

pdwMaxLength
szCanonicalized 문자의 길이를 포함하는 변수에 대한 포인터입니다. 함수가 성공하면 변수는 종료 null 문자를 포함하여 버퍼에 기록된 문자 수를 받습니다. 함수가 실패하면 변수는 종료 null 문자에 대한 공간을 포함하여 버퍼의 필요한 길이(바이트)를 받습니다.

dwFlags
이 함수의 동작을 제어하는 플래그를 ATL_URL.

• ATL_URL_BROWSER_MODE "#" 또는 "?" 뒤에 있는 문자를 인코딩하거나 디코딩하지 않으며 "?" 뒤에 나오는 공백을 제거하지 않습니다. 이 값을 지정하지 않으면 전체 URL이 인코딩되고 후행 공백이 제거됩니다.

• ATL_URL_DECODE URL을 구문 분석하기 전에 모든 %XX 시퀀스를 이스케이프 시퀀스를 포함한 문자로 변환합니다.

• ATL_URL_ENCODE_PERCENT 발견된 백분율 기호를 인코딩합니다. 기본적으로 백분율 기호는 인코딩되지 않습니다.

• ATL_URL_ENCODE_SPACES_ONLY 공백만 인코딩합니다.

• ATL_URL_ESCAPE 모든 이스케이프 시퀀스(%XX)를 해당 문자로 변환합니다.

• ATL_URL_NO_ENCODE 안전하지 않은 문자를 이스케이프 시퀀스로 변환하지 않습니다.

• ATL_URL_NO_META URL에서 메타 시퀀스(예: "." 및 "..")를 제거하지 않습니다.

Return Value

성공하면 TRUE를 반환하고 실패하면 FALSE를 반환합니다.

설명

InternetCanonicalizeUrl의 현재 버전처럼 동작하지만 WinInet 또는 Internet Explorer를 설치할 필요는 없습니다.

AtlCombineUrl

기본 URL과 상대 URL을 단일 정규 URL로 결합하려면 이 함수를 호출합니다.

inline BOOL AtlCombineUrl(
   LPCTSTR szBaseUrl,
   LPCTSTR szRelativeUrl,
   LPTSTR szBuffer,
   DWORD* pdwMaxLength,
   DWORD dwFlags = 0) throw();

매개 변수

szBaseUrl
기본 URL입니다.

szRelativeUrl
기준 URL을 기준으로 하는 URL입니다.

szBuffer
정식화된 URL을 수신하기 위해 호출자가 할당한 버퍼입니다.

pdwMaxLength
szBuffer 문자의 길이가 들어 있는 변수에 대한 포인터입니다. 함수가 성공하면 변수는 종료 null 문자를 포함하여 버퍼에 기록된 문자 수를 받습니다. 함수가 실패하면 변수는 종료 null 문자에 대한 공간을 포함하여 버퍼의 필요한 길이(바이트)를 받습니다.

dwFlags
이 함수의 동작을 제어하는 플래그입니다. AtlCanonicalizeUrl을 참조하세요.

Return Value

성공하면 TRUE를 반환하고 실패하면 FALSE를 반환합니다.

설명

InternetCombineUrl의 현재 버전처럼 동작하지만 WinInet 또는 Internet Explorer를 설치할 필요는 없습니다.

AtlEscapeUrl

모든 안전하지 않은 문자를 이스케이프 시퀀스로 변환하려면 이 함수를 호출합니다.

inline BOOL AtlEscapeUrl(
   LPCSTR szStringIn,
   LPSTR szStringOut,
   DWORD* pdwStrLen,
   DWORD dwMaxLength,
   DWORD dwFlags = 0) throw();

inline BOOL AtlEscapeUrl(
   LPCWSTR szStringIn,
   LPWSTR szStringOut,
   DWORD* pdwStrLen,
   DWORD dwMaxLength,
   DWORD dwFlags = 0) throw();

매개 변수

lpszStringIn
변환할 URL입니다.

lpszStringOut
변환된 URL을 쓸 호출자 할당 버퍼입니다.

pdwStrLen
DWORD 변수에 대한 포인터입니다. 함수가 성공 하면 pdwStrLen 은 종료 null 문자를 포함하여 버퍼에 기록된 문자 수를 받습니다. 함수가 실패하면 변수는 종료 null 문자에 대한 공간을 포함하여 버퍼의 필요한 길이(바이트)를 받습니다. 이 메서드 의 와이드 문자 버전을 사용하는 경우 pdwStrLen 은 바이트 수가 아니라 필요한 문자 수를 받습니다.

dwMaxLength
버퍼 lpszStringOut의 크기입니다.

dwFlags
이 함수의 동작을 제어하는 플래그를 ATL_URL. 가능한 값은 ATLCanonicalizeUrl을 참조하세요.

Return Value

성공하면 TRUE를 반환하고 실패하면 FALSE를 반환합니다.

AtlGetDefaultUrlPort

특정 인터넷 프로토콜 또는 체계와 관련된 기본 포트 번호를 가져오려면 이 함수를 호출합니다.

inline ATL_URL_PORT AtlGetDefaultUrlPort(ATL_URL_SCHEME m_nScheme) throw();

매개 변수

m_nScheme
포트 번호를 가져올 체계를 식별하는 ATL_URL_SCHEME 값입니다.

Return Value

지정한 스키마와 연결된 ATL_URL_PORT 또는 스키마가 인식되지 않는 경우 ATL_URL_INVALID_PORT_NUMBER.

AtlIsUnsafeUrlChar

URL에서 문자를 안전하게 사용할 수 있는지 확인하려면 이 함수를 호출합니다.

inline BOOL AtlIsUnsafeUrlChar(char chIn) throw();

매개 변수

턱
안전을 위해 테스트할 문자입니다.

Return Value

입력 문자가 안전하지 않으면 TRUE를 반환하고, 그렇지 않으면 FALSE를 반환합니다.

설명

URL에서 사용하지 않아야 하는 문자는 이 함수를 사용하여 테스트하고 AtlCanonicalizeUrl을 사용하여 변환할 수 있습니다.

AtlUnescapeUrl

이스케이프된 문자를 원래 값으로 다시 변환하려면 이 함수를 호출합니다.

inline BOOL AtlUnescapeUrl(
   LPCSTR szStringIn,
   LPSTR szStringOut,
   LPDWORD pdwStrLen,
   DWORD dwMaxLength) throw();

inline BOOL AtlUnescapeUrl(
   LPCWSTR szStringIn,
   LPWSTR szStringOut,
   LPDWORD pdwStrLen,
   DWORD dwMaxLength) throw();

매개 변수

lpszStringIn
변환할 URL입니다.

lpszStringOut
변환된 URL을 쓸 호출자 할당 버퍼입니다.

pdwStrLen
DWORD 변수에 대한 포인터입니다. 함수가 성공하면 변수는 종료 null 문자를 포함하여 버퍼에 기록된 문자 수를 받습니다. 함수가 실패하면 변수는 종료 null 문자에 대한 공간을 포함하여 버퍼의 필요한 길이(바이트)를 받습니다.

dwMaxLength
버퍼 lpszStringOut의 크기입니다.

Return Value

성공하면 TRUE를 반환하고 실패하면 FALSE를 반환합니다.

설명

AtlEscapeUrl에 의해 적용된 변환 프로세스를 반대로 바뀝니다.

RGBToHtml

COLORREF 값을 해당 색 값에 해당하는 HTML 텍스트로 변환합니다.

bool inline RGBToHtml(
   COLORREF color,
   LPTSTR pbOut,
   long nBuffer);

매개 변수

color
RGB 색 값입니다.

pbOut
HTML 색 값에 대한 텍스트를 수신하기 위해 호출자가 할당한 버퍼입니다. 버퍼에는 null 종결자에 대한 공간을 포함하여 8자 이상의 공백이 있어야 합니다.)

nBuffer
버퍼의 크기(null 종결자에 대한 공간 포함)입니다.

Return Value

성공하면 TRUE를 반환하고 실패하면 FALSE를 반환합니다.

설명

HTML 색 값은 6자리 16진수 값 뒤에 6자리 16진수 값으로, 색의 각 빨강, 녹색 및 파란색 구성 요소에 대해 2자리를 사용합니다(예: #FFFFFF 흰색임).

SystemTimeToHttpDate

시스템 시간을 HTTP 헤더에서 사용하기에 적합한 형식의 문자열로 변환하려면 이 함수를 호출합니다.

inline void SystemTimeToHttpDate(
   const SYSTEMTIME& st,
   CStringA& strTime);

매개 변수

st
HTTP 형식 문자열로 가져올 시스템 시간입니다.

strTime
RFC 2616() 및 RFC 1123https://www.ietf.org/rfc/rfc1123.txt(https://www.ietf.org/rfc/rfc2616.txt)에 정의된 대로 HTTP 날짜 시간을 수신하는 문자열 변수에 대한 참조입니다.

참고 항목

개념
ATL COM 데스크톱 구성 요소
InternetCanonicalizeUrl