yyc12345/YYCCommonplace
1
0
Fork 0
Code Activity

doc: update comments of code.

Browse Source 
- add lost testbench for wchar encoding convertion.
- update code documentation.
This commit is contained in:
yyc12345
2024-06-18 16:03:41 +08:00
parent 77b6f439f7
commit f153f9bc22
6 changed files with 92 additions and 22 deletions
Download Patch File Download Diff File Expand all files Collapse all files

6
src/COMHelper.hpp
View File

@@ -12,16 +12,16 @@
/**
* @brief COM fucntions related namespace.
* @details
* This namespace is Windows specific and it will disappear on other platforms.
* This namespace is Windows specific and is unavailable on other platforms.
*
* This namespace contain a COM Guard which make sure COM was initialized in current module when loading current module.
* It is essential because all calling to COM functions should be under the premise that COM has been initialized.
* This guard also will uninitialize COM when unloading this module.
*
* This namespace also provided various memory-safe types for interacting with COM functions.
* Although Microsoft also has similar smart pointer called CComPtr.
* Although Microsoft also has similar smart pointer called \c CComPtr.
* But this library is eager to hide all Microsoft-related functions calling.
* Using CComPtr is not corresponding with the philosophy of this library.
* Using \c CComPtr is not corresponding with the philosophy of this library.
* So these std-based smart pointer type were created.
*
* This namespace is used by internal functions as intended.