RpcNsProfileEltRemove function
The RpcNsProfileEltRemove function removes an element from a profile.
Syntax
RPC_STATUS RPC_ENTRY RpcNsProfileEltRemove( unsigned long ProfileNameSyntax, unsigned char *ProfileName, RPC_IF_ID *IfId, unsigned long MemberNameSyntax, unsigned char *MemberName );
Parameters
- ProfileNameSyntax
-
Syntax of ProfileName.
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.
- ProfileName
-
Pointer to the name of the profile from which to remove an element.
- IfId
-
Pointer to the interface identification of the profile element to be removed.
Specify a null value to remove the default profile member.
- MemberNameSyntax
-
Syntax of MemberName.
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.
- MemberName
-
Pointer to the name service–entry name in the profile element to remove.
Return value
| Value | Meaning |
|---|---|
|
The call succeeded. |
|
The name syntax is invalid. |
|
The name syntax is not supported. |
|
The name is incomplete. |
|
The name-service entry was not found. |
|
The name service is unavailable. |
Remarks
The RpcNsProfileEltRemove function removes a profile element from the profile attribute in the ProfileName entry. This function requires an exact match of the MemberName and IfId parameters to remove a profile element. The entry (MemberName), included as a member in the profile element, is not deleted.
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 |
RpcNsProfileEltRemoveW (Unicode) and RpcNsProfileEltRemoveA (ANSI) |
See also