Declaring FunctionsInstallShield 20

Declaring Functions
InstallShield 2014

The first step in creating a user-defined function is to declare the function. The keyword prototype tells the InstallShield script compiler that the line contains a function definition.

To declare a function:

1. Type the keyword prototype.
2. Type the function’s return type. (This step is optional. If you do not enter a return type, it is assumed that the function returns a NUMBER value or no value.) To specify that the function does not return a value, type void.
3. On the same line, enter the function name.
4. After the function name, type the data types of the parameters, and enclose them in parentheses and separate them by commas.
5. If there are no parameters, put empty parentheses to the right of the function name.
6. End the line with a semicolon (;).

In the following examples, FunctionName is a function containing three parameters. The arguments passed when calling FunctionName must be, in order, INT, STRING, and SHORT. CopyBitmapExample has no parameters. FileTransfer has five parameters—three LONG variables and two STRING variables—and returns a NUMBER value.

prototype FunctionName (INT, STRING, SHORT);

prototype CopyBitmapExample( );

prototype NUMBER FileTransfer (LONG, LONG, LONG, STRING, STRING);

When you are declaring DLL functions, use the format . for the name of the DLL file function. For example:

prototype MyDLL.MyFunction(INT, INT);

The above declaration signals to the InstallScript compiler that the program will call a function named MyFunction, with two INT parameters, in a file named Mydll.dll.

You can also optionally declare a calling convention, either cdecl or stdcall, when declaring a DLL file function. For example:

prototype cdecl MyDLL.MyFunction(INT, INT);

If you do not explicitly declare a calling convention, InstallShield uses stdcall. If you explicitly declare both a calling convention and a return type, place the calling convention before the return type.

Note: Most Windows API functions use the stdcall calling convention, but some C or C++ development environments build DLL file functions with the cdecl calling convention unless you prototype your C or C++ function with the __stdcall modifier. For more information, consult your compiler documentation.

Many Windows API functions are declared in the header file ISRTWindows.h, which is automatically included when you include Ifx.h in your script. (You can prevent the automatic definition of Windows APIs by placing the preprocessor constant ISINCLUDE_NO_WINAPI_H in the Preprocessor Defines box on the Compile/Link tab of the Settings dialog box.)

See Also

Declarations

Data Types and Predefined Structures

Pointers

InstallShield Help Library
May 2014 Copyright Information | Contact Us

Kết quả (Việt) 1:

Tuyên bố chức năngInstallShield 2014 Bước đầu tiên trong việc tạo ra một chức năng người dùng định nghĩa là tuyên bố các chức năng. Chiếc nguyên mẫu từ khóa cho trình biên dịch kịch bản InstallShield dòng chứa một định nghĩa chức năng.Tuyên bố một chức năng: 1. loại nguyên mẫu từ khóa. 2. nhập các chức năng trả lại loại. (Bước này là tùy chọn. Nếu bạn không nhập một loại trở lại, nó giả định rằng các chức năng trả về một giá trị số hoặc không có giá trị.) Để chỉ định các chức năng không trở về một giá trị, nhập vô hiệu. 3. trên cùng một dòng, nhập tên chức năng. 4. sau khi tên chức năng, nhập các loại dữ liệu của các tham số, sau đó kèm theo họ trong ngoặc đơn và tách chúng bằng dấu phẩy. 5. nếu không có không có tham số, đưa ngoặc trống ở bên phải của tên chức năng. 6. cuối cùng dòng với một dấu chấm phẩy (;). Trong ví dụ sau đây, FunctionName là một hàm có ba tham số. Các đối số được thông qua khi gọi FunctionName phải, trong trật tự, INT, CHUỖI và ngắn. CopyBitmapExample đã không tham biến. FileTransfer có 5 thông số — biến dài ba và hai CHUỖI biến — và trả về một giá trị số.mẫu thử nghiệm FunctionName (INT, CHUỖI, ngắn);mẫu thử nghiệm CopyBitmapExample ();nguyên mẫu số hiệu FileTransfer (dài, dài, LONG, STRING, STRING);Khi bạn tuyên bố DLL chức năng, sử dụng định dạng . cho tên chức năng tập tin DLL. Ví dụ:mẫu thử nghiệm MyDLL.MyFunction (INT, INT);Tuyên bố trên tín hiệu để trình biên dịch InstallScript rằng chương trình sẽ gọi một hàm được đặt theo tên MyFunction, với hai tham số INT, trong một tập tin tên Mydll.dll.Bạn có thể tùy ý cũng tuyên bố một hội nghị gọi, cdecl hoặc stdcall, khi tuyên bố một DLL file chức năng. Ví dụ:mẫu thử nghiệm cdecl MyDLL.MyFunction (INT, INT);Nếu bạn không rõ ràng tuyên bố một hội nghị gọi, InstallShield sử dụng stdcall. Nếu bạn một cách rõ ràng tuyên bố một hội nghị gọi điện thoại và một loại trở lại, nơi hội nghị kêu gọi trước khi loại trở lại.Lưu ý: Hầu hết Windows API chức năng sử dụng stdcall gọi hội nghị, nhưng một số C hoặc c + + phát triển môi trường xây dựng DLL tập tin chức năng với cdecl gọi hội nghị, trừ khi bạn có nguyên mẫu của bạn C hoặc c + + hoạt động với công cụ sửa đổi __stdcall. Để biết thêm chi tiết, tham khảo tài liệu trình biên dịch của bạn.Nhiều Windows API chức năng được tuyên bố trong các tập tin tiêu đề ISRTWindows.h, mà là tự động bao gồm khi bạn bao gồm Ifx.h trong kịch bản của bạn. (Bạn có thể ngăn chặn định nghĩa tự động của Windows API bằng cách đặt liên tục ISINCLUDE_NO_WINAPI_H preprocessor trong định nghĩa Preprocessor hộp trên tab biên dịch/liên kết của hộp thoại thiết đặt.)Xem thêmKhai báo Loại dữ liệu và cấu trúc được xác định trước Con trỏ InstallShield trợ giúp thư việnTháng 5 năm 2014 bản quyền thông tin | Liên hệ với chúng tôi

Kết quả (Việt) 2:

Kê khai chức năng
InstallShield 2014 Bước đầu tiên trong việc tạo ra một chức năng người dùng định nghĩa là khai báo hàm. Các mẫu thử nghiệm từ khóa cho trình biên dịch script InstallShield rằng dòng chứa một định nghĩa chức năng. Để khai báo một hàm: 1. Gõ từ khóa nguyên mẫu. 2. Nhập kiểu trả về của hàm. (Bước này là tùy chọn. Nếu bạn không nhập một kiểu trả về, nó được giả định rằng hàm trả về một giá trị số hoặc không có giá trị.) Để xác định rằng hàm không trả về một giá trị, kiểu void. 3. Trên cùng một dòng, nhập tên hàm. 4. Sau khi tên hàm, gõ các kiểu dữ liệu của tham số, và đặt chúng trong dấu ngoặc đơn và tách chúng bằng dấu phẩy. 5. Nếu không có tham số, đặt dấu ngoặc rỗng bên phải của tên hàm. 6. Kết thúc dòng với một dấu chấm phẩy (;). Trong ví dụ sau đây, FunctionName là một chức năng có chứa ba thông số. Các đối số được truyền khi gọi FunctionName phải, theo thứ tự, INT, STRING, và SHORT. CopyBitmapExample không có thông số. FileTransfer có năm tham số-ba biến DÀI và hai STRING biến và trả về một giá trị số. FunctionName mẫu thử nghiệm (INT, STRING, SHORT); nguyên mẫu CopyBitmapExample (); mẫu số FileTransfer (LONG, LONG, LONG, STRING, STRING); Khi là việc khai báo hàm DLL, sử dụng định dạng




















.cho tên của các chức năng tập tin DLL. Ví dụ: nguyên mẫu MyDLL.MyFunction (INT, INT); . Các tín hiệu khai báo ở trên để trình biên dịch InstallScript rằng chương trình sẽ gọi một hàm có tên MyFunction, với hai tham số INT, trong một tập tin có tên Mydll.dll Bạn cũng có thể tùy chọn khai báo một ước gọi, hoặc cdecl hoặc stdcall, khi khai báo một hàm tập tin DLL. Ví dụ: nguyên mẫu cdecl MyDLL.MyFunction (INT, INT); Nếu bạn không khai báo rõ ràng một quy ước gọi, sử dụng InstallShield stdcall. Nếu bạn khai báo một cách rõ ràng cả một quy ước gọi và kiểu trả về, đặt quy ước gọi trước kiểu trả về. Lưu ý: chức năng Windows Hầu hết các API sử dụng stdcall gọi quy ước, nhưng một số C hoặc C ++ môi trường phát triển xây dựng các chức năng tập tin DLL với quy ước gọi cdecl trừ khi bạn mẫu thử nghiệm C hay C ++ chức năng với các sửa đổi lần __stdcall. Để biết thêm thông tin, tham khảo tài liệu trình biên dịch của bạn. Nhiều chức năng Windows API được khai báo trong file header ISRTWindows.h, được tự động đưa vào khi bạn bao gồm Ifx.h trong kịch bản của bạn. (Bạn có thể ngăn chặn các định nghĩa tự động của Windows API bằng cách đặt tiền xử lý ISINCLUDE_NO_WINAPI_H đổi trong hộp Preprocessor Định nghĩa trên Compile / tab Link của hộp thoại Settings.) Xem thêm khai báo kiểu dữ liệu và các cấu trúc Predefined Pointers InstallShield Trợ giúp Thư viện Tháng năm 2014 Copyright thông tin | Liên hệ