RpcNsMgmtEntryDelete
The RpcNsMgmtEntryDelete
function deletes a name-service database entry.
#include <rpc.h>
RPC_STATUS RPC_ENTRY RpcNsMgmtEntryDelete(
|
unsigned long EntryNameSyntax, |
|
|
unsigned char * EntryName |
|
|
); |
|
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
name of the entry to delete.
Remarks
The RpcNsMgmtEntryDelete
routine removes an entry from the name-service database.
Management
applications use this routine only when an entry is no longer needed for example, when a server is being permanently
removed from service.
Because
name-service databases are designed to be relatively stable, the frequent use
of the RpcNsMgmtEntryDelete routine in client or server applications can
result in performance problems. Creating and deleting entries in client or
server applications causes the name-service database to repeatedly remove and
replace the same entry. This can lead to performance problems in replicated
name-service databases.
Return Values
|
Value |
Meaning |
|
RPC_S_OK |
Success |
|
RPC_S_INVALID_NAME_SYNTAX |
Invalid
name syntax |
|
RPC_S_UNSUPPORTED_NAME_SYNTAX |
Unsupported
name syntax |
|
RPC_S_INCOMPLETE_NAME |
Incomplete
name |
|
RPC_S_ENTRY_NOT_FOUND |
Name-service
entry not found |
|
RPC_S_NAME_SERVICE_UNAVAILABLE |
Name
service unavailable |
|
RPC_S_NOT_RPC_ENTRY |
Not an RPC
entry |
See Also