VMS Help  —  DCE  DCE_RPC, API Runtime Intro, Logical Names
   The RPC Name Service Interface (NSI) routines uses the following
   logical names:

     +  RPC_DEFAULT_ENTRY
        Designates the default entry in the name service database that
        the import and lookup routines use as the starting point to
        search for binding information for a compatible server.
        Normally, the starting entry is a profile.

        An application that uses a default entry name must define this
        logical name.  The RPC runtime does not provide a default.
        For example, suppose that a client application needs to search
        the name service database for a server binding handle.  The
        application can use the rpc_ns_binding_import_begin() routine
        as part of the search.  If so, the application must specify, to
        the routine's entry_name parameter, the name of the entry in the
        name service database at which to begin the search.  If the
        search is to begin at the entry that the RPC_DEFAULT_ENTRY
        logical name specifies, then the application must specify the
        value NULL to parameter entry_name in
        rpc_ns_binding_import_begin().

     +  RPC_DEFAULT_ENTRY_SYNTAX
        Specifies the syntax of the name provided in the
        RPC_DEFAULT_ENTRY logical name.  In addition, provides the
        syntax for those RPC NSI routines that allow a default value
        for the name syntax argument.  If the RPC_DEFAULT_ENTRY_SYNTAX
        logical name is not defined, the RPC runtime uses the
        rpc_c_ns_syntax_dce name syntax.  (For the valid name syntaxes
        in this reference page and for the valid syntax values, see the
        table in the description of the frequently used routine argument
        name_syntax, which appears later in this reference page.)

   Optionally, each application defines either or both of the first two
   logical names.  The application can change the value of either one,
   or both, at any time during runtime.
Close Help