2.2.7.2.1 action Element

The action XML element directs the client to execute a method at a specific entry point in a specific file on the client computer.

The action element SHOULD contain text data, encoded as a null-terminated UTF-16LE string ([RFC2781] section 4.2), to pass to the method indicated by the entrypoint attribute. The mechanism by which the client invokes the executable code is specific to the client implementation.<2>

 <xs:element name="action">
   <xs:complexType>
     <xs:simpleContent>
       <xs:extension
         base="xs:string"
       >
         <xs:attribute name="dll"
           type="xs:string"
           use="required"
          />
         <xs:attribute name="entrypoint"
           type="xs:string"
           use="required"
          />
       </xs:extension>
     </xs:simpleContent>
   </xs:complexType>
 </xs:element>

Attributes

Name

Type

Description

dll

xs:string

The value of this attribute is a string that contains the driver-file name of a file on the client system that contains executable code. The driver-file name MUST NOT contain any of the following Unicode standard [UNICODE] characters:

 \ (character code U+005C)

/ (character code U+002F)

? (character code U+003F)

* (character code U+002A)

< (character code U+003C)

> (character code U+003E)

" (character code U+0022)

| (character code U+007C)

: (character code U+003A)

entrypoint

xs:string

The value of this attribute is a string that specifies a public method in the file designated by the dll attribute.