RpcNsEntryExpandName
The RpcNsEntryExpandName
function expands a name-service entry name.
#include <rpc.h>
RPC_STATUS RPC_ENTRY RpcNsEntryExpandName(
unsigned long EntryNameSyntax, |
|
unsigned char * EntryName, |
|
unsigned char * * ExpandedName |
|
); |
|
Parameters
EntryNameSyntax
Specifies an
integer value that indicates the syntax of the next argument, EntryName.
To use the
syntax specified in the registry value
HKEY_LOCAL_MACHINE\Software\Microsoft\Rpc\NameService\
DefaultSyntax, provide a value of RPC_C_NS_SYNTAX_DEFAULT.
EntryName
Points to the
entry name to expand.
ExpandedName
Returns a
pointer to a pointer to the expanded version of EntryName.
Remarks
Note This DCE
function is not supported by the Microsoft Locator version 1.0.
An
application calls the RpcNsEntryExpandName routine to obtain a fully expanded
entry name.
The RPC
run-time library allocates memory for the returned ExpandedName
argument. The application is responsible for calling the RpcStringFree
routine for that returned argument string.
The returned
expanded entry name accounts for local name translations and for differences in
locally defined naming schemas.
Return Values
Value |
Meaning |
RPC_S_OK |
Success |
RPC_S_INCOMPLETE_NAME |
Incomplete
name |
See Also