xpfCreateProtectedData

FUNCTION xpfCreateProtectedData(model                            : GENERIC;
                                instanceTypeNameOrInstanceTypeId : GENERIC;
                                createCondition                  : STRING;
                                writeCondition                   : STRING;
                                attributeNameOrAttributeId1      : GENERIC;
                                attribute1WriteCondition         : STRING;
                                attribute1value                  : GENERIC;
                                attributeNameOrAttributeId2      : GENERIC;
                                attribute2WriteCondition         : STRING;
                                attribute2value                  : GENERIC;
                                . . .
                                attributeNameOrAttributeIdN      : GENERIC;
                                attributeNWriteCondition         : STRING;
                                attributeNvalue                  : GENERIC)
                                newInstanceId                    : INTEGER;
                

This function creates an instance of the specified defined EDMprotectedData. The actual EDMprotectedData must be defined as an instance type in the related xpxDefineProtectedData() operation. No EDMtransaction must be open when this function is invoked. An EDMwriteTransaction will be stated by this method and committed when successfully performed, and aborted when this methods fails.  The actual EDMprotectedData must have been defined with xpxCREATE_ACCESS before this function can be successfully performed. The specified "createCondition" defined in the related xpxDefineProtectedData() must be evaluated to TRUE before this function can be successfully performed. When the optional argument "createCondition" is specified, this condition must be evaluated to TRUE before this function can be successfully performed.

This function can optionally assign value to one or more attributes of the created instance. The setting of attribute values will only be successfully when the actual EDMprotectedData have xpxWRITE_ACCESS, and the optional EDMprotectedData's defined "writeCondition" is evaluated to TRUE. Similar the optional "writeCondition" argument must be evaluated to TRUE. For each attribute to write the actual attribute must have been defined with xpxWRITE_ACCESS, the optional defined "attributeCondition" must be evaluated to TRUE, and the optional "attributeWriteCondition" argument must be evaluated to TRUE before the actual attribute write operation can be successfully performed.

Arguments

Return Value

Options

Example

<Missing Example>

See also