Initialize Method
Initializes the class.
Syntax
int Initialize(const char* lpszProductGUID);
INT Initialize(LPCWSTR lpszProductGUID);
Remarks
This method initializes the class, and must be called each time the application starts before attempting to call any of the class's other methods. (If the application uses multiple instances of the class, only the first instance needs to call this method.)
ProductGUID is used to distinguish between driver installations performed by different applications. Such information is necessary to guard against unexpected situations such as, e.g., the driver being uninstalled by one application despite other applications still needing it.
Therefore, to ensure proper operation, it is critical that each individual application have its own unique ProductGUID value, and that applications (and their installation scripts) use that value when calling any of the following methods:
- Install
- Uninstall
- GetDriverStatus
- GetModuleVersion
- RegisterIcon
- UnregisterIcon
- Initialize
Error Handling (C++)
This method returns a result code; 0 indicates success, while a non-zero error code indicates that this method encountered an error during its execution. If an error occurs, the GetLastError() method can be called to retrieve the associated error message. (Note: This method's result code can also be obtained by calling the GetLastErrorCode() method after it returns.)