A Configuration Manager 2007 policy message is used to describe the XML for a policy assignment. A list of policy assignments is returned from the endpoint.

Input Message XML

The following input XML describes a policy assignment request.

The RequestAssignments message is used to obtain a list of policy assignments for the client. Each assignment has a condition and a URL for the policy body. The client is expected to evaluate the condition and, if applicable, download the policy URL.

<RequestAssignments>

    <PolicySource></PolicySource>

    <Identification>

        <Machine>

            <ClientID></ClientID>

            <NetBIOSName></NetBIOSName>

            <FQDN></FQDN>

            <SID></SID>

        </Machine>

        <User>

            <NT4UserName></NT4UserName>

            <SID></SID>

            <ServerCookie></ServerCookie>

            <UserGroups>

                 <SID></SID>

             </UserGroups>

        </User>

    </Identification>

    <Resource></Resource>

</RequestAssignments>

Output Message XML

The following output XML describes the list of policy assignments.

<ReplyAssignments>

    <Identification>

        <Machine>

            <ClientID></ClientID>

            <NetBIOSName></NetBIOSName>

            <FQDN></FQDN>

            <SID></SID>

        </Machine>

        <User>

            <NT4UserName></NT4UserName>

            <SID></SID>

        </User>

    </Identification>

    <PolicySource></PolicySource>

    <Resource></Resource>

    <ServerCookie></ServerCookie>

    <Signature>

        <Reference>

            <SignatureAlgorithm></SignatureAlgorithm>

            <SignatureValue></SignatureValue>

        </Reference>

    </Signature>

    <PolicyAssignment>

        <Policy>

            <PolicyLocation></PolicyLocation>

        </Policy>

    </PolicyAssignment>

    <PolicyAssignment>

        <Condition>

            <Expression></Expression>

        </Condition>

    </PolicyAssignment>

</ReplyAssignments>

Remarks

You use ISmsMessaging::Invoke Method to pass the message to the policy endpoint, MP_PolicyManager. You set the target endpoint with ISmsMessage::SetTargetEndpoint Method.

The input XML is passed in the Invoke.pRequest parameter. The output XML is returned in the Invoke.ppReply parameter.

The following security flags may be applied to the message:

Security Mode Required Optional

Mixed

MPAPI_SECURITY_FLAG_MIXED_MODE

None.

Native

MPAPI_SECURITY_FLAG_NATIVE_MODE

MPAPI_SECURITY_FLAG_SIGN_MESSAGE

MPAPI_SECURITY_FLAG_ENABLE_CRL_CHECKING

Use ISmsMessage4::SetSecurityFlags Methodto set the security flags for the message.

For information about MPAPI security flags, see MPAPI_SECURITY_FLAGS Enumeration.

See Also


Send comments about this topic to Microsoft.