Funzione RpcNsMgmtBindingUnexportW (rpcnsi.h)

La funzione RpcNsMgmtBindingUnexport rimuove più handle di associazione e oggetti da una voce nel database name-service.

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

 

Sintassi

RPC_STATUS RpcNsMgmtBindingUnexportW(
  unsigned long EntryNameSyntax,
  RPC_WSTR      EntryName,
  RPC_IF_ID     *IfId,
  unsigned long VersOption,
  UUID_VECTOR   *ObjectUuidVec
);

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 cui rimuovere handle di associazione e UUID oggetto.

IfId

Puntatore a un'identificazione dell'interfaccia. Un valore di parametro Null indica che gli handle di associazione non devono essere esportati. Solo gli UUID oggetto devono essere non esportati.

VersOption

Specifica il modo in cui la funzione RpcNsMgmtBindingUnexport usa il VersMajor e Membri versMinor della struttura a cui punta il parametro IfId .

Nella tabella seguente vengono descritti i valori validi per il parametro VersOption .

Valori versOption	Significato
RPC_C_VERS_ALL	Annulla tutte le associazioni per l'UUID dell'interfaccia in IfId, indipendentemente dai numeri di versione. Per questo valore, specificare 0 per le versioni principali e secondarie in IfId.
RPC_C_VERS_IF_ID	Annulla l'estensione delle associazioni per l'UUID dell'interfaccia compatibile in IfId con la stessa versione principale e con una versione secondaria maggiore o uguale alla versione secondaria in IfId.
RPC_C_VERS_EXACT	Annulla l'esportazione delle associazioni per l'UUID dell'interfaccia in IfId con le stesse versioni principali e secondarie di IfId.
RPC_C_VERS_MAJOR_ONLY	Annulla l'esportazione delle associazioni per l'UUID dell'interfaccia in IfId con la stessa versione principale di IfId (ignora la versione secondaria). Per questo valore, specificare 0 per la versione secondaria in IfId.
RPC_C_VERS_UPTO	Annulla l'estensione delle associazioni che offrono una versione dell'UUID dell'interfaccia specificata minore o uguale alla versione principale e secondaria specificata. Ad esempio, se il IfId contenuto V2.0 e la voce name service-database contiene handle di associazione con le versioni 1.3, 2.0 e 2.1, la RpcNsMgmtBindingUnexport funzione unexporterebbe gli handle di associazione con le versioni 1.3 e 2.0.

ObjectUuidVec

Puntatore a un vettore di UUID oggetto che il server non vuole più offrire. L'applicazione costruisce questo vettore. Un valore Null indica che non sono presenti UUID oggetto da annullare. Solo gli handle di associazione devono essere non esportati.

Valore restituito

Valore	Significato
RPC_S_OK	Chiamata riuscita.
RPC_S_INVALID_VERS_OPTION	L'opzione di versione non è valida.
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_INTERFACE_NOT_FOUND	L'interfaccia non è stata trovata.
RPC_S_NOT_ALL_OBJS_UNEXPORTED	Non tutti gli oggetti non sono stati esportati.

 

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

 

Osservazioni

La funzione rpcNsMgmtBindingUnexport consente a un'applicazione di gestione di rimuovere una delle opzioni seguenti da una voce del database del servizio nome:

• Tutti gli handle di associazione per un UUID di interfaccia specificato, qualificato dai numeri di versione dell'interfaccia (principale e secondario)
• Uno o più UUID oggetto di risorse
• Handle di associazione e UUID oggetto delle risorse

Un'applicazione di gestione può annullare l'estensione di interfacce e oggetti in una singola chiamata a RpcNsMgmtBindingUnexportoppure può annullarle separatamente. Se RpcNsMgmtBindingUnexport non trova alcun handle di associazione per l'interfaccia specificata, la funzione restituisce un codice di stato RPC_S_INTERFACE_NOT_FOUND e non esporta gli UUID dell'oggetto, se specificati.

Se vengono trovati uno o più handle di associazione per l'interfaccia specificata senza errori, RpcNsMgmtBindingUnexport annullare l'esportazione degli UUID oggetto specificati. Se uno degli UUID dell'oggetto specificato non è stato trovato, RpcNsMgmtBindingUnexport restituisce RPC_S_NOT_ALL_OBJS_UNEXPORTED.

Oltre a chiamare RpcNsMgmtBindingUnexport, un'applicazione di gestione deve anche chiamare la funzione RpcMgmtEpUnregister per annullare la registrazione dei server registrati con il database di mapping degli endpoint.

Nota database name-service sono progettati per essere relativamente stabili. Nei servizi dei nomi replicati, l'uso frequente delle funzioni RpcNsBindingExportExport e RpcNsBindingUnexport fa sì che il servizio dei nomi rimuova ripetutamente e sostituisca la stessa voce, causando problemi di prestazioni.

 

Nota

L'intestazione rpcnsi.h definisce RpcNsMgmtBindingUnexport 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

RpcMgmtEpUnregister

RpcNsBindingExport

RpcNsBindingUnexport