4.5 Querying a Record from a WINS Database

The following example illustrates the use of the RPC methods defined in this specification to query a record from the database of a WINS server. This example assumes that the WINS database contained by the specified server has an active multihomed (1) dynamic record named "WINS-TEST-00001" mapped to two IP addresses: 192.168.1.1 and 192.168.1.2. IP address 192.168.1.1 has node type p, and its time stamp set to 0x61. IP address 192.168.1.2 has a version ID type and a time stamp set to 0x101E. 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_QUERY.

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

    • NameLen to 16.

  • All other members are used for output, which the server assigns as follows:

    • TypOfRec_e contains 3.

    • NoOfAdds contains 2.

    • pAdd points to two IP addresses: 192.168.1.1 and 192.168.1.2.

    • VersNo contains 0x61.

    • NodeTyp contains 1.

    • OwnerId contains the owner IP address of the matching record.

    • State_e contains zero (ACTIVE).

    • fStatic contains zero.

    • TimeStamp contains 0x101E.