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。
如果成功,则返回 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。
如果成功,则返回 TRUE;如果失败,则返回 FALSE。
AtlGetDefaultUrlPort
调用此函数可获取与特定 Internet 协议或方案关联的默认端口号。
inline ATL_URL_PORT AtlGetDefaultUrlPort(ATL_URL_SCHEME m_nScheme) throw();
m_nScheme
ATL_URL_SCHEME 值用于标识要为其获取端口号的方案。
与指定方案关联的 ATL_URL_PORT;如果未识别方案,则为 ATL_URL_INVALID_PORT_NUMBER。
AtlIsUnsafeUrlChar
调用此函数可了解字符在 URL 中能否安全使用。
inline BOOL AtlIsUnsafeUrlChar(char chIn) throw();
出于安全要测试的字符。
如果输入字符不安全,则返回 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 的大小。
如果成功,则返回 TRUE;如果失败,则返回 FALSE。
反转 AtlEscapeUrl 应用的转换过程。
RGBToHtml
将 COLORREF 值转换为与颜色值相对应的 HTML 文本。
bool inline RGBToHtml(
COLORREF color,
LPTSTR pbOut,
long nBuffer);
color
RGB 颜色值。
pbOut
调用方分配的缓冲区,用于接收 HTML 颜色值的文本。 缓冲区必须具有至少 8 个字符的空间,包括 null 终止符的空间)。
nBuffer
缓冲区的大小(以字节为单位)(包括 null 终止符的空间)。
如果成功,则返回 TRUE;如果失败,则返回 FALSE。
HTML 颜色值由井号加 6 未十六进制值表示,其中颜色的红黄蓝三个成分分别由 2 位数字表示(比如,#FFFFFF 表示白色)。
SystemTimeToHttpDate
调用此函数可将系统时间转换为采用适合在 HTTP 标头中使用的格式的字符串。
inline void SystemTimeToHttpDate(
const SYSTEMTIME& st,
CStringA& strTime);
作为 HTTP 格式字符串获取的系统时间。
strTime
对字符串变量的引用,可接收 RFC 2616 (https://www.ietf.org/rfc/rfc2616.txt) 和 RFC 1123 (https://www.ietf.org/rfc/rfc1123.txt) 中定义的 HTTP 日期时间。
ATL COM 桌面组件
InternetCanonicalizeUrl