RpcNsEntryExpandName function
The RpcNsEntryExpandName function expands a name-service entry name. This function is supported by Active Directory.
Syntax
RPC_STATUS RPC_ENTRY RpcNsEntryExpandName( unsigned long EntryNameSyntax, unsigned char *EntryName, unsigned char **ExpandedName );
Parameters
- EntryNameSyntax
-
Syntax of EntryName.
To use the syntax specified in the registry value entry HKEY_LOCAL_MACHINE\Software\Microsoft\Rpc\NameService\DefaultSyntax, provide a value of RPC_C_NS_SYNTAX_DEFAULT.
- EntryName
-
Pointer to the entry name to expand.
- ExpandedName
-
Returns a pointer to a pointer to the expanded version of EntryName.
Return value
| Value | Meaning |
|---|---|
|
The call succeeded. |
|
The name is incomplete. |
Remarks
An application calls the RpcNsEntryExpandName function to obtain a fully expanded entry name.
The RPC run-time library allocates memory for the returned ExpandedName parameter. The application is responsible for calling the RpcStringFree function for that returned string.
The returned expanded entry name accounts for local name translations and for differences in locally defined naming schema.
Requirements
|
Minimum supported client |
Windows 2000 Professional [desktop apps only] |
|---|---|
|
Minimum supported server |
Windows 2000 Server [desktop apps only] |
|
Header |
|
|
Library |
|
|
DLL |
|
|
Unicode and ANSI names |
RpcNsEntryExpandNameW (Unicode) and RpcNsEntryExpandNameA (ANSI) |
See also