3.3.1.4.1 Binding Lookup

  • Article

  1. The client locator MUST invoke the I_nsi_lookup_begin method with the following parameters:

    1. If an entry name is specified in the request, the client locator MUST initialize the entry_name parameter with the entry name in the syntax specified by RPC_C_NS_SYNTAX_DCE, and the entry_name_syntax MUST be initialized to RPC_C_NS_SYNTAX_DCE. If the entry name is not specified in the request, this parameter MUST be set to NULL.

    2. If an interface is specified in the request, the client locator MUST initialize the interfaceid parameter with the interface identifier and version information. If the interface is not specified in the request, this parameter MUST be set to NULL.

    3. If a transfer syntax is specified for the interface specified in the request, the client locator MUST initialize the xfersyntax parameter with the transfer syntax identifier and version information. If a transfer syntax is not specified in the request, this parameter MUST be set to NULL.

    4. If object UUIDs are specified in the request, the client locator MUST initialize the obj_uuid parameter with the object UUIDs specified in the request. If the object UUIDs are not specified in the request, this parameter MUST be set to NULL.

    5. The client locator MUST initialize a value for the Binding_max_count as appropriate for the implementation.<14>

    6. The client locator MUST initialize a value for the MaxCacheAge based on the request.<15>

  2. The client locator MUST use the context handle received to enumerate results matching the criteria by invoking the I_nsi_lookup_next method with the context handle.

  3. The client locator MUST invoke the I_nsi_lookup_done method with the context handle to free resources associated with the context handle.