PreviousNext

Environment Variables

The RPC Name Service Interface (NSI) routines use the following environment variables:

· 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 environment variable. 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 environment variable specifies, then the application must specify the value NULL to parameter entry_name in rpc_ns_binding_import_begin(3rpc).

· RPC_DEFAULT_ENTRY_SYNTAX
Specifies the syntax of the name provided in the RPC_DEFAULT_ENTRY environment variable. 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 environment variable 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 in this reference page.)

Optionally, each application defines either or both of the first two environment variables. The application can change the value of either one, at any time during runtime.