You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/atl/atl-encoding-reference.md
+24-24Lines changed: 24 additions & 24 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -40,35 +40,35 @@ Encoding in a range of common Internet standards such as uuencode, hexadecimal,
40
40
41
41
|||
42
42
|-|-|
43
-
|[AtlGetHexValue](../Topic/AtlGetHexValue.md)|Call this function to get the numeric value of a hexadecimal digit.|
44
-
|[AtlHexDecode](../Topic/AtlHexDecode.md)|Decodes a string of data that has been encoded as hexadecimal text such as by a previous call to [AtlHexEncode](../Topic/AtlHexEncode.md).|
45
-
|[AtlHexDecodeGetRequiredLength](../Topic/AtlHexDecodeGetRequiredLength.md)|Call this function to get the size in bytes of a buffer that could contain data decoded from a hex-encoded string of the specified length.|
46
-
|[AtlHexEncode](../Topic/AtlHexEncode.md)|Call this function to encode some data as a string of hexadecimal text.|
47
-
|[AtlHexEncodeGetRequiredLength](../Topic/AtlHexEncodeGetRequiredLength.md)|Call this function to get the size in characters of a buffer that could contain a string encoded from data of the specified size.|
48
-
|[AtlUnicodeToUTF8](../Topic/AtlUnicodeToUTF8.md)|Call this function to convert a Unicode string to UTF-8.|
49
-
|[BEncode](../Topic/BEncode.md)|Call this function to convert some data using the "B" encoding.|
50
-
|[BEncodeGetRequiredLength](../Topic/BEncodeGetRequiredLength.md)|Call this function to get the size in characters of a buffer that could contain a string encoded from data of the specified size.|
51
-
|[EscapeXML](../Topic/EscapeXML.md)|Call this function to convert characters that are unsafe for use in XML to their safe equivalents.|
52
-
|[GetExtendedChars](../Topic/GetExtendedChars.md)|Call this function to get the number of extended characters in a string.|
53
-
|[IsExtendedChar](../Topic/IsExtendedChar.md)|Call this function to find out if a given character is an extended character (less than 32, greater than 126, and not a tab, linefeed or carriage return)|
54
-
|[QEncode](../Topic/QEncode.md)|Call this function to convert some data using the "Q" encoding.|
55
-
|[QEncodeGetRequiredLength](../Topic/QEncodeGetRequiredLength.md)|Call this function to get the size in characters of a buffer that could contain a string encoded from data of the specified size.|
56
-
|[QPDecode](../Topic/QPDecode.md)|Decodes a string of data that has been encoded in quoted-printable format such as by a previous call to [QPEncode](../Topic/QPEncode.md).|
57
-
|[QPDecodeGetRequiredLength](../Topic/QPDecodeGetRequiredLength.md)|Call this function to get the size in bytes of a buffer that could contain data decoded from quoted-printable-encoded string of the specified length.|
58
-
|[QPEncode](../Topic/QPEncode.md)|Call this function to encode some data in quoted-printable format.|
59
-
|[QPEncodeGetRequiredLength](../Topic/QPEncodeGetRequiredLength.md)|Call this function to get the size in characters of a buffer that could contain a string encoded from data of the specified size.|
60
-
|[UUDecode](../Topic/UUDecode.md)|Decodes a string of data that has been uuencoded such as by a previous call to [UUEncode](../Topic/UUEncode.md).|
61
-
|[UUDecodeGetRequiredLength](../Topic/UUDecodeGetRequiredLength.md)|Call this function to get the size in bytes of a buffer that could contain data decoded from a uuencoded string of the specified length.|
62
-
|[UUEncode](../Topic/UUEncode.md)|Call this function to uuencode some data.|
63
-
|[UUEncodeGetRequiredLength](../Topic/UUEncodeGetRequiredLength.md)|Call this function to get the size in characters of a buffer that could contain a string encoded from data of the specified size.|
43
+
|[AtlGetHexValue](http://msdn.microsoft.com/Library/d6868900-7e1b-44c0-9a73-9635f3f2811e)|Call this function to get the numeric value of a hexadecimal digit.|
44
+
|[AtlHexDecode](http://msdn.microsoft.com/Library/305ccc56-7f96-4795-b297-b04e58c98187)|Decodes a string of data that has been encoded as hexadecimal text such as by a previous call to [AtlHexEncode](http://msdn.microsoft.com/Library/256f1d5c-ca40-488e-bcfb-503cf6ac0ea8).|
45
+
|[AtlHexDecodeGetRequiredLength](http://msdn.microsoft.com/Library/d2a28877-fe5e-420d-93b4-3b46d910d752)|Call this function to get the size in bytes of a buffer that could contain data decoded from a hex-encoded string of the specified length.|
46
+
|[AtlHexEncode](http://msdn.microsoft.com/Library/256f1d5c-ca40-488e-bcfb-503cf6ac0ea8)|Call this function to encode some data as a string of hexadecimal text.|
47
+
|[AtlHexEncodeGetRequiredLength](http://msdn.microsoft.com/Library/7decfd9b-7227-4676-b16f-f50ffc6c0caa)|Call this function to get the size in characters of a buffer that could contain a string encoded from data of the specified size.|
48
+
|[AtlUnicodeToUTF8](http://msdn.microsoft.com/Library/104f13d8-379c-4bb0-b894-e54cad7ed9aa)|Call this function to convert a Unicode string to UTF-8.|
49
+
|[BEncode](http://msdn.microsoft.com/Library/cb8f07fb-d0a6-438f-97e9-459ac34df11f)|Call this function to convert some data using the "B" encoding.|
50
+
|[BEncodeGetRequiredLength](http://msdn.microsoft.com/Library/2bd75b97-fe14-4b30-99c6-b943269eef25)|Call this function to get the size in characters of a buffer that could contain a string encoded from data of the specified size.|
51
+
|[EscapeXML](http://msdn.microsoft.com/Library/bc8793f9-538a-487a-b47d-2ef95e84a15b)|Call this function to convert characters that are unsafe for use in XML to their safe equivalents.|
52
+
|[GetExtendedChars](http://msdn.microsoft.com/Library/26c5fa33-f313-4c4b-baf7-cca2ac11885c)|Call this function to get the number of extended characters in a string.|
53
+
|[IsExtendedChar](http://msdn.microsoft.com/Library/9c6721f5-ddfb-478b-a976-fe015bdf2ec1)|Call this function to find out if a given character is an extended character (less than 32, greater than 126, and not a tab, linefeed or carriage return)|
54
+
|[QEncode](http://msdn.microsoft.com/Library/6dba5385-ecfc-4a18-85ab-4e8a224384f9)|Call this function to convert some data using the "Q" encoding.|
55
+
|[QEncodeGetRequiredLength](http://msdn.microsoft.com/Library/7f9faf68-66a5-4f33-87c4-dcd97eeaae4f)|Call this function to get the size in characters of a buffer that could contain a string encoded from data of the specified size.|
56
+
|[QPDecode](http://msdn.microsoft.com/Library/c5caf731-9bc4-4740-8899-720f84ed014c)|Decodes a string of data that has been encoded in quoted-printable format such as by a previous call to [QPEncode](http://msdn.microsoft.com/Library/f6ea53d6-3677-48bd-8717-74a3900fa3c5).|
57
+
|[QPDecodeGetRequiredLength](http://msdn.microsoft.com/Library/84750f57-75c3-4c0d-bcfa-57a55d034198)|Call this function to get the size in bytes of a buffer that could contain data decoded from quoted-printable-encoded string of the specified length.|
58
+
|[QPEncode](http://msdn.microsoft.com/Library/f6ea53d6-3677-48bd-8717-74a3900fa3c5)|Call this function to encode some data in quoted-printable format.|
59
+
|[QPEncodeGetRequiredLength](http://msdn.microsoft.com/Library/68652cfd-17f0-45c6-a12a-3a6096ea11e5)|Call this function to get the size in characters of a buffer that could contain a string encoded from data of the specified size.|
60
+
|[UUDecode](http://msdn.microsoft.com/Library/5841f625-166f-4f4a-a4f8-841982fa7a22)|Decodes a string of data that has been uuencoded such as by a previous call to [UUEncode](http://msdn.microsoft.com/Library/26fc4290-23ed-4f40-935a-93f30edab161).|
61
+
|[UUDecodeGetRequiredLength](http://msdn.microsoft.com/Library/abfa1d1f-caf6-4029-a94c-1a48937791dd)|Call this function to get the size in bytes of a buffer that could contain data decoded from a uuencoded string of the specified length.|
62
+
|[UUEncode](http://msdn.microsoft.com/Library/26fc4290-23ed-4f40-935a-93f30edab161)|Call this function to uuencode some data.|
63
+
|[UUEncodeGetRequiredLength](http://msdn.microsoft.com/Library/df54060a-ed3b-4883-bdae-5d4b28db7c86)|Call this function to get the size in characters of a buffer that could contain a string encoded from data of the specified size.|
64
64
65
65
### Macros
66
66
67
67
|||
68
68
|-|-|
69
-
|[ATL_ESC Flags](../Topic/ATL_ESC%20Flags.md)|These flags are used to control the behavior of [EscapeXML](../Topic/EscapeXML.md).|
70
-
|[ATLSMTP_QPENCODE Flags](../Topic/ATLSMTP_QPENCODE%20Flags.md)|These flags describe how quoted-printable encoding is to be performed by [QPEncode](../Topic/QPEncode.md).|
71
-
|[ATLSMTP_UUENCODE Flags](../Topic/ATLSMTP_UUENCODE%20Flags.md)|These flags describe how uuencoding is to be performed by [UUEncode](../Topic/UUEncode.md).|
69
+
|[ATL_ESC Flags](http://msdn.microsoft.com/Library/daf3aa3c-7498-4d63-9fb6-e05b4815c2b8)|These flags are used to control the behavior of [EscapeXML](http://msdn.microsoft.com/Library/bc8793f9-538a-487a-b47d-2ef95e84a15b).|
70
+
|[ATLSMTP_QPENCODE Flags](http://msdn.microsoft.com/Library/6b15a3ab-8e57-49e4-8104-09b26ebb96c4)|These flags describe how quoted-printable encoding is to be performed by [QPEncode](http://msdn.microsoft.com/Library/f6ea53d6-3677-48bd-8717-74a3900fa3c5).|
71
+
|[ATLSMTP_UUENCODE Flags](http://msdn.microsoft.com/Library/ecb79b81-b764-4a48-a05c-a9dee6e7bbce)|These flags describe how uuencoding is to be performed by [UUEncode](http://msdn.microsoft.com/Library/26fc4290-23ed-4f40-935a-93f30edab161).|
|[AtlAdvise](../Topic/AtlAdvise.md), [CComPtrBase::Advise](../atl/reference/ccomptrbase-class.md#advise)|[AtlUnadvise](../Topic/AtlUnadvise.md)|Vtable or dual interfaces|Yes|`AtlAdvise` is a global ATL function. `CComPtrBase::Advise` is used by [CComPtr](../atl/reference/ccomptr-class.md) and [CComQIPtr](../atl/reference/ccomqiptr-class.md).|
62
+
|[AtlAdvise](http://msdn.microsoft.com/Library/625a2f03-6b7f-4761-be5d-d2871d1d3254), [CComPtrBase::Advise](../atl/reference/ccomptrbase-class.md#advise)|[AtlUnadvise](http://msdn.microsoft.com/Library/939d2e50-e2df-4e8f-a16a-e9650b8f0340)|Vtable or dual interfaces|Yes|`AtlAdvise` is a global ATL function. `CComPtrBase::Advise` is used by [CComPtr](../atl/reference/ccomptr-class.md) and [CComQIPtr](../atl/reference/ccomqiptr-class.md).|
63
63
|[IDispEventSimpleImpl::DispEventAdvise](../atl/reference/idispeventsimpleimpl-class.md#dispeventadvise)|[IDispEventSimpleImpl::DispEventUnadvise](../atl/reference/idispeventsimpleimpl-class.md#dispeventunadvise)|[IDispEventImpl](../atl/reference/idispeventimpl-class.md) or [IDispEventSimpleImpl](../atl/reference/idispeventsimpleimpl-class.md)|No|Fewer parameters than `AtlAdvise` since the base class does more work.|
64
64
|[CComCompositeControl::AdviseSinkMap(TRUE)](../atl/reference/ccomcompositecontrol-class.md#advisesinkmap)|[CComCompositeControl::AdviseSinkMap(FALSE)](../atl/reference/ccomcompositecontrol-class.md#advisesinkmap)|ActiveX controls in Composite controls|No|`CComCompositeControl::AdviseSinkMap` advises all entries in the event sink map. The same function unadvises the entries. This method is called automatically by the `CComCompositeControl` class.|
65
65
|[CAxDialogImpl::AdviseSinkMap(TRUE)](../atl/reference/caxdialogimpl-class.md#advisesinkmap)|[CAxDialogImpl::AdviseSinkMap(FALSE)](../atl/reference/caxdialogimpl-class.md#advisesinkmap)|ActiveX controls in a dialog box|No|`CAxDialogImpl::AdviseSinkMap` advises and unadvises all ActiveX controls in the dialog resource. This is done automatically for you.|
Copy file name to clipboardExpand all lines: docs/atl/atl-utilities-reference.md
+13-13Lines changed: 13 additions & 13 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -58,20 +58,20 @@ ATL provides code for manipulating paths and URLs in the form of [CPathT](../atl
58
58
59
59
|||
60
60
|-|-|
61
-
|[ATL_URL_SCHEME](../Topic/ATL_URL_SCHEME.md)|The members of this enumeration provide constants for the schemes understood by [CUrl](../atl/reference/curl-class.md).|
61
+
|[ATL_URL_SCHEME](http://msdn.microsoft.com/Library/f4131046-8ba0-4ec1-8209-84203f05d20e)|The members of this enumeration provide constants for the schemes understood by [CUrl](../atl/reference/curl-class.md).|
62
62
63
63
### Functions
64
64
65
65
|||
66
66
|-|-|
67
-
|[AtlCanonicalizeUrl](../Topic/AtlCanonicalizeUrl.md)|Call this function to canonicalize a URL, which includes converting unsafe characters and spaces into escape sequences.|
68
-
|[AtlCombineUrl](../Topic/AtlCombineUrl.md)|Call this function to combine a base URL and a relative URL into a single, canonical URL.|
69
-
|[AtlEscapeUrl](../Topic/AtlEscapeUrl.md)|Call this function to convert all unsafe characters to escape sequences.|
70
-
|[AtlGetDefaultUrlPort](../Topic/AtlGetDefaultUrlPort.md)|Call this function to get the default port number associated with a particular internet protocol or scheme.|
71
-
|[AtlHexValue](../Topic/AtlHexValue.md)|Call this function to get the numeric value of a hexadecimal digit.|
72
-
|[AtlIsUnsafeUrlChar](../Topic/AtlIsUnsafeUrlChar.md)|Call this function to find out whether a character is safe for use in a URL.|
73
-
|[AtlUnescapeUrl](../Topic/AtlUnescapeUrl.md)|Call this function to convert escaped characters back to their original values.|
74
-
|[SystemTimeToHttpDate](../Topic/SystemTimeToHttpDate.md)|Call this function to convert a system time to a string in a format suitable for using in HTTP headers.|
67
+
|[AtlCanonicalizeUrl](http://msdn.microsoft.com/Library/80015d95-081d-4bbb-a176-77670cdb16e8)|Call this function to canonicalize a URL, which includes converting unsafe characters and spaces into escape sequences.|
68
+
|[AtlCombineUrl](http://msdn.microsoft.com/Library/c5bb1b78-6eb3-4a27-92ad-0e48d8d5846a)|Call this function to combine a base URL and a relative URL into a single, canonical URL.|
69
+
|[AtlEscapeUrl](http://msdn.microsoft.com/Library/e4413300-dd10-43ad-9eaf-772e58398316)|Call this function to convert all unsafe characters to escape sequences.|
70
+
|[AtlGetDefaultUrlPort](http://msdn.microsoft.com/Library/d894e370-0236-4f19-b4a1-eba50c07550b)|Call this function to get the default port number associated with a particular internet protocol or scheme.|
71
+
|[AtlHexValue](http://msdn.microsoft.com/Library/503446a2-a363-49f4-9fd6-f39071959cdd)|Call this function to get the numeric value of a hexadecimal digit.|
72
+
|[AtlIsUnsafeUrlChar](http://msdn.microsoft.com/Library/bf434973-0530-48ea-86cc-f40551e4d4a3)|Call this function to find out whether a character is safe for use in a URL.|
73
+
|[AtlUnescapeUrl](http://msdn.microsoft.com/Library/f6174219-3f95-4446-bc39-8e4bd1520eb2)|Call this function to convert escaped characters back to their original values.|
74
+
|[SystemTimeToHttpDate](http://msdn.microsoft.com/Library/3e240f32-1d64-422d-a281-31b2d1273962)|Call this function to convert a system time to a string in a format suitable for using in HTTP headers.|
75
75
|[ATLPath::AddBackslash]$$brokenlink$$(../Topic/ATLPath%20Class.md#addbackslash)|This function is an overloaded wrapper for [PathAddBackslash](http://msdn.microsoft.com/library/windows/desktop/bb773561).|
76
76
|[ATLPath::AddExtension]$$brokenlink$$(../Topic/ATLPath%20Class.md#addextension)|This function is an overloaded wrapper for [PathAddExtension](http://msdn.microsoft.com/library/windows/desktop/bb773563).|
77
77
|[ATLPath::Append]$$brokenlink$$(../Topic/ATLPath%20Class.md#append)|This function is an overloaded wrapper for [PathAppend](http://msdn.microsoft.com/library/windows/desktop/bb773565).|
@@ -113,10 +113,10 @@ ATL provides code for manipulating paths and URLs in the form of [CPathT](../atl
113
113
114
114
|||
115
115
|-|-|
116
-
|[ATL_URL Flags](../Topic/ATL_URL%20Flags.md)|These flags modify the behavior of [AtlEscapeUrl](../Topic/AtlEscapeUrl.md) and [AtlCanonicalizeUrl](../Topic/AtlCanonicalizeUrl.md) .|
117
-
|[ATL_WORKER_THREAD_WAIT](../Topic/ATL_WORKER_THREAD_WAIT.md)|This macro defines the default value in milliseconds that [CWorkerThread::Shutdown](../atl/reference/cworkerthread-class.md#shutdown) will wait for the worker thread to shut down.|
118
-
|[ATLS_DEFAULT_THREADPOOLSHUTDOWNTIMEOUT](../Topic/ATLS_DEFAULT_THREADPOOLSHUTDOWNTIMEOUT.md)|This macro defines the default time in milliseconds that [CThreadPool](../atl/reference/cthreadpool-class.md) will wait for a thread to shut down.|
119
-
|[ATLS_DEFAULT_THREADSPERPROC](../Topic/ATLS_DEFAULT_THREADSPERPROC.md)|This macro defines the default number of threads per processor used by [CThreadPool](../atl/reference/cthreadpool-class.md).|
116
+
|[ATL_URL Flags](http://msdn.microsoft.com/Library/76e8cc5c-4e17-4eb1-ac29-a94d5256c4a7)|These flags modify the behavior of [AtlEscapeUrl](http://msdn.microsoft.com/Library/e4413300-dd10-43ad-9eaf-772e58398316) and [AtlCanonicalizeUrl](http://msdn.microsoft.com/Library/80015d95-081d-4bbb-a176-77670cdb16e8) .|
117
+
|[ATL_WORKER_THREAD_WAIT](http://msdn.microsoft.com/Library/4d209004-47f4-4c6a-98b4-aee49ffb0911)|This macro defines the default value in milliseconds that [CWorkerThread::Shutdown](../atl/reference/cworkerthread-class.md#shutdown) will wait for the worker thread to shut down.|
118
+
|[ATLS_DEFAULT_THREADPOOLSHUTDOWNTIMEOUT](http://msdn.microsoft.com/Library/c1e660a7-d490-42af-bbe1-ded76e80cc10)|This macro defines the default time in milliseconds that [CThreadPool](../atl/reference/cthreadpool-class.md) will wait for a thread to shut down.|
119
+
|[ATLS_DEFAULT_THREADSPERPROC](http://msdn.microsoft.com/Library/e0dcf107-72a9-4122-abb4-83c63aa7d571)|This macro defines the default number of threads per processor used by [CThreadPool](../atl/reference/cthreadpool-class.md).|
Copy file name to clipboardExpand all lines: docs/atl/changing-the-default-class-factory-and-aggregation-model.md
+4-4Lines changed: 4 additions & 4 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -43,15 +43,15 @@ translation.priority.ht:
43
43
# Changing the Default Class Factory and Aggregation Model
44
44
ATL uses [CComCoClass](../atl/reference/ccomcoclass-class.md) to define the default class factory and aggregation model for your object. `CComCoClass` specifies the following two macros:
45
45
46
-
-[DECLARE_CLASSFACTORY](../Topic/DECLARE_CLASSFACTORY.md) Declares the class factory to be [CComClassFactory](../atl/reference/ccomclassfactory-class.md).
46
+
-[DECLARE_CLASSFACTORY](http://msdn.microsoft.com/Library/51a6b925-07c0-4d3a-9174-0b8c808975e4) Declares the class factory to be [CComClassFactory](../atl/reference/ccomclassfactory-class.md).
47
47
48
-
-[DECLARE_AGGREGATABLE](../Topic/DECLARE_AGGREGATABLE.md) Declares that your object can be aggregated.
48
+
-[DECLARE_AGGREGATABLE](http://msdn.microsoft.com/Library/e7e568d7-04e0-4226-b5dc-224deed229ab) Declares that your object can be aggregated.
49
49
50
-
You can override either of these defaults by specifying another macro in your class definition. For example, to use [CComClassFactory2](../atl/reference/ccomclassfactory2-class.md) instead of `CComClassFactory`, specify the [DECLARE_CLASSFACTORY2](../Topic/DECLARE_CLASSFACTORY2.md) macro:
50
+
You can override either of these defaults by specifying another macro in your class definition. For example, to use [CComClassFactory2](../atl/reference/ccomclassfactory2-class.md) instead of `CComClassFactory`, specify the [DECLARE_CLASSFACTORY2](http://msdn.microsoft.com/Library/38a6c969-7297-4bb1-9ba6-1fe2d355b285) macro:
Two other macros that define a class factory are [DECLARE_CLASSFACTORY_AUTO_THREAD](../Topic/DECLARE_CLASSFACTORY_AUTO_THREAD.md) and [DECLARE_CLASSFACTORY_SINGLETON](../Topic/DECLARE_CLASSFACTORY_SINGLETON.md).
54
+
Two other macros that define a class factory are [DECLARE_CLASSFACTORY_AUTO_THREAD](http://msdn.microsoft.com/Library/19d7105e-03e8-4412-9f5e-5384c8a5e18f) and [DECLARE_CLASSFACTORY_SINGLETON](http://msdn.microsoft.com/Library/0e4a3964-c03d-463e-884c-fe3b416db478).
55
55
56
56
ATL also uses the `typedef` mechanism to implement default behavior. For example, the `DECLARE_AGGREGATABLE` macro uses `typedef` to define a type called **_CreatorClass**, which is then referenced throughout ATL. Note that in a derived class, a `typedef` using the same name as the base class's `typedef` results in ATL using your definition and overriding the default behavior.
0 commit comments