MSFT_MPFProcDefinition

WMI class that represents procedure definitions of Microsoft® Provisioning Framework (MPF) registered in the configuration database. Used by Configuration Database WMI Provider.

Syntax

class MSFT_MPFProcDefinition
{
	[
		key,
		PropMap("NamespaceId=NamespaceId")
	]
	MSFT_MPFNamespace ref Namespace;

	[key]
	string ProcedureName;


	sint16 AccessType;
	sint16 RequestType;
	string Description;
	string InputSchema;
	string OutputSchema;
	string ProcedureData;
	string InvokeXML;
	boolean PerfEnabled;
	boolean SaveDataForRollback;
	boolean AuditEnabled;

	string AccessSecurityDesc;

	[
		PropMap("CredentialsID=RunAsCredentialsID")
	]
	MSFT_MPFCredential ref RunAsCredential;
};

Table
ProcDefinition

Properties

MSFT_MPFNamespace ref Namespace * +
A reference to the namespace that owns the procedure.
ProcedureName *
A string that stores the name of the procedure.
AccessType
A sint16 that identifies the access type of the procedure. A procedure is either public or private (default). A public procedure can be called from an incoming request outside of MPF, but a private procedure can only be called from within MPF. For more information, see procedure.
0: Private
1: Public
RequestType
A sint16 that identifies the procedure type.
1: Read; invokes only an execute function to process the request with no rollback function.
2: Write; invokes both an execute function to process the request and a rollback function to implement after a failure.
3: Two-phase enabled; invokes an execute function and a prepare function to process the request. It also invokes either a commit function or a rollback function, depending on whether the prepare and process actions complete successfully.
Description
A string that describes the procedure.
InputSchema
A string that identifies the input schema for the procedure, if any.
OutputSchema
A string that identifies the output schema for the procedure, if any.
ProcedureData
A string that encapsulates free-form XML data used by the procedure's execute and queue nodes. Procedure data is local to the procedure and not exposed to the caller. See also procedureData.
InvokeXML
A string that implements procedure steps for calling a provider or another procedure. You can modify a procedure's XML directly in the configuration database, but this practice is not recommended. Instead, you should modify and test the XML outside of the production environment, then import it once testing is complete.
PerfEnabled
A boolean that specifies whether to automatically implement performance counters for the procedure.
SaveDataForRollback
A boolean that specifies whether to automatically save the input data that enables the rollback of a failed procedure. It is recommended that you not change this property. Doing so can cause data and system corruption if a transaction fails.
AuditEnabled
A boolean that specifies whether procedure calls are saved to the audit log. This setting corresponds to the auditEnabled attribute in the namespace XML procedure node. In addition to marking a procedure for audit, you can also configure the audit level for procedure calls. For more information, see Provisioning Engines.
AccessSecurityDesc
A string that specifies who can execute each procedure and determines the permissions to allow or deny each user. By default, permissions propagate from the namespace to its procedures, so changes to permissions apply to all procedures. However, you can override this default behavior for individual procedures.
MSFT_MPFCredential ref RunAsCredential +
A reference to the user credentials with which MPF invokes the procedure. Only credentials previously defined in Provisioning Manager can be selected. This option does not display for read-only namespaces such as Error Provider, and the field is not enabled unless at least one user credential exists in the configuration database. For more information on the Execute as property, see Basic Authentication.
 
* Key property
+ Reference property

See also

MSDN® information on Windows Management Instrumentation (WMI), MSFT_MPFCredential, MSFT_MPFNamespace

Up Top of Page
© 1999-2002 Microsoft Corporation. All rights reserved.