Funzione RpcNsMgmtEntryDeleteW (rpcnsi.h)

Articolo
11/20/2024

La funzione RpcNsMgmtEntryDelete elimina una voce nome service-database.

Nota Questa funzione non è supportata in Windows Vista e nei sistemi operativi successivi.

Sintassi

RPC_STATUS RpcNsMgmtEntryDeleteW(
  unsigned long EntryNameSyntax,
  RPC_WSTR      EntryName
);

Parametri

EntryNameSyntax

Sintassi di EntryName.

Per usare la sintassi specificata nella voce del valore del Registro di sistema HKEY_LOCAL_MACHINE\Software\Microsoft\Rpc\NameService\DefaultSyntax, specificare il valore RPC_C_NS_SYNTAX_DEFAULT.

EntryName

Puntatore al nome della voce da eliminare.

Valore restituito

Valore	Significato
RPC_S_OK	Chiamata riuscita.
RPC_S_INVALID_NAME_SYNTAX	La sintassi del nome non è valida.
RPC_S_UNSUPPORTED_NAME_SYNTAX	La sintassi del nome non è supportata.
RPC_S_INCOMPLETE_NAME	Il nome è incompleto.
RPC_S_ENTRY_NOT_FOUND	Impossibile trovare la voce name-service.
RPC_S_NAME_SERVICE_UNAVAILABLE	Il servizio dei nomi non è disponibile.
RPC_S_NOT_RPC_ENTRY	Non una voce RPC.

Nota Per un elenco di codici di errore validi, vedere RPC Return Values.

Osservazioni

Le applicazioni di gestione usano la funzione rpcNsMgmtEntryDelete solo quando una voce non è più necessaria, ad esempio quando un server viene rimosso definitivamente dal servizio.

Poiché i database name-service sono progettati per essere relativamente stabili, l'uso frequente di RpcNsMgmtEntryDelete nelle applicazioni client o server può causare problemi di prestazioni. La creazione e l'eliminazione di voci nelle applicazioni client o server fa sì che il database name-service rimuovono e sostituiscono ripetutamente la stessa voce. Ciò può causare problemi di prestazioni nei database name-service replicati.

Nota

L'intestazione rpcnsi.h definisce RpcNsMgmtEntryDelete come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 2000 Professional [solo app desktop]
server minimo supportato	Windows 2000 Server [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	rpcnsi.h (include Rpc.h)
libreria	Rpcns4.lib
dll	Rpcns4.dll

Vedere anche

RpcNsMgmtEntryCreare

Condividi tramite