4.4 Modifying a Record from a WINS Database

The following example illustrates the use of the RPC methods defined in this specification to modify a WINS server database record. If the WINS database on the specified server has a multihomed (1) dynamic record with the name "WINS-TEST-00001" and the node type set to p-node, the client calls the RPC method R_WinsRecordAction (section 3.1.4.1) with the following parameters:

  • ServerHdl set to the endpoint of the WINS server on which the R_WinsRecordAction method is executed.

  • ppRecAction pointing to a structure of type WINSINTF_RECORD_ACTION_T (section 2.2.2.3), with members set as follows:

    • Cmd_e to WINSINTF_E_MODIFY.

    • pName to point to the string "WINS-TEST-00001" followed by a NetBIOS suffix of 0x00.

    • NameLen to 16.

    • TypOfRec_e to 3, indicating a multihomed (1) record.

    • NodeTyp to 3.

    • State_e to 1.

    • fStatic to zero.

After executing the call to R_WinsRecordAction, the node type and the state of the existing record are modified to h-node and RELEASED, respectively.