LabWindows/CVI

Content Type
Programming Language
Current manual

CA_SetLocale

CA_SetLocale

HRESULT CA_SetLocale (CAObjHandle objectHandle, LCID locale);

Purpose

Sets the locale that the ActiveX server uses to interpret the arguments that it receives as parameters to its functions.

Parameters

Input
Name Type Description
objectHandle CAObjHandle ActiveX object handle returned by one of the object creation functions in this library or an ActiveX server method.
locale LCID The locale you want to use. Usually, you should pass LOCALE_NEUTRAL, which signifies the default locale of the server. Refer to www.msdn.com for more information.

Return Value

Name Type Description
status HRESULT A value indicating whether an error occurred. Negative error codes indicate function failure.

Error codes are defined in CVIversion\include\cviauto.h and <Program Files>\National Instruments\Shared\MSDTRedistributables\SDKHeaderFiles\8.1\winerror.h. The LabWindows/CVI ActiveX Library explicitly returns error codes. Other error codes in winerror.h are generated by ActiveX servers and passed on to you by the LabWindows/CVI ActiveX Library.

You can use CA_GetAutomationErrorString to get the description of an error code or CA_DisplayErrorInfo to display the description of the error code.

Additional Information

Library: ActiveX Library

Include file: cviauto.h

LabWindows/CVI compatibility: LabWindows/CVI 5.0 and later

Was this information helpful?

Help us improve your future ni.com experience.

What are you trying to do?

Submit