ValidateProperties method overview
The ValidateProperties method is called to ensure that all required properties are set and that there are no mutually exclusive property settings.
MPIRC ValidateProperties (HMPIADAPT hAdapter)
Inputs
- hAdapter
- Adapter handle
Outputs
None
Returns
Success status
The adapter properties are not set by most modes of execution. Therefore, it is necessary for the adapter to get the command line property, to parse it, and to set the properties within this method.
To get the command line property, issue the following property
call:
mpiPropertyGetText(hAdapter, MPIP_ADAPTER_COMMANDLINE, 0, &lpszCmdLine, &nLen)
After the command line has been fetched, it should be parsed and
a number of mpiPropertySet* calls should be made. In the process,
the options should be validated to ensure that they are consistent
and mutually compatible. To store additional properties or other information for the adapter, set the MPIP_ADAPTER_USER_DATA property in the adapter object. In subsequent calls, the user data can be retrieved by calling mpiGetPropertyBinaryPointer. If the MPIP_ADAPTER_USER_DATA property is set, the adapter must free this memory in the DestroyAdapterInstance call.