Common Exits DLL Interface
DLL deployed program exits must export the function with the following prototype:
cim1265
DLL deployed program exits must export the function with the following prototype:
int function_name( char Input_XML, char *Return_XML, int *Return_Buffer_Length)
The following list describes the parameters for the DLL deployed program exit prototype:
- function_nameName of the program exit. One DLL can export multiple program exits, where each program exit is an exported function with the prototype defined above.
- InputXMLCharacter buffer in UTF-8 format. It contains the XML buffer that the Provisioning Server passes to the program exit.
- ReturnXMLCharacter buffer in UTF-8 format., Iit is an empty buffer that the Provisioning Server passes to the program exit for it to send a return value back to the Provisioning Server. The size of the buffer is passed to the program exit is the Return_Buffer_Length parameter.
- Return_Buffer_LengthBoth an input and output parameter:
- On input, Return_Buffer_Length indicates the maximum length, in characters, that the Return_XML buffer can contain. The program exits must not exceed this length when building the return XML buffer.
- On output, Return_Buffer_Length contains the actual length of the return XML buffer the program exit built. That is, after the program exit builds the return XML buffer, it sets Return_Buffer_Length to the actual length of the buffer being returned.