Funzione RpcNsMgmtBindingUnexportA (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 RpcNsMgmtBindingUnexportA(
  unsigned long EntryNameSyntax,
  RPC_CSTR      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 non esportati. Solo gli UUID oggetto devono essere non esportati.

VersOption

Specifica il modo in cui la funzione RpcNsMgmtBindingUnexport utilizza i membri VersMajor e 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 le 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 le associazioni per l'UUID dell'interfaccia in IfId con le stesse versioni principali e secondarie di IfId.
RPC_C_VERS_MAJOR_ONLY	Annulla le 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'espressione delle associazioni che offrono una versione dell'UUID dell'interfaccia specificata minore o uguale alla versione principale e secondaria specificata. Ad esempio, se ifId conteneva V2.0 e la voce di database name service-database conteneva handle di associazione con le versioni 1.3, 2.0 e 2.1, la funzione RpcNsMgmtBindingUnexport avrebbe esportato 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	La chiamata ha avuto esito positivo.
RPC_S_INVALID_VERS_OPTION	L'opzione 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	La voce name-service non è stata trovata.
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 esportati.

 

Nota Per un elenco di codici di errore validi, vedere Valori restituiti RPC.

 

Commenti

La funzione RpcNsMgmtBindingUnexport consente a un'applicazione di gestione di rimuovere uno dei seguenti elementi da una voce name service-database:

• 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'exportazione di interfacce e oggetti in una singola chiamata a RpcNsMgmtBindingUnexport oppure può annullarne l'exporting separatamente. Se RpcNsMgmtBindingUnexport non trova handle di associazione per l'interfaccia specificata, la funzione restituisce un codice di stato RPC_S_INTERFACE_NOT_FOUND e non eseporta gli UUID dell'oggetto, se sono stati specificati.

Se uno o più handle di associazione per l'interfaccia specificata vengono trovati e non esportati senza errori, RpcNsMgmtBindingUnexport annulla l'exporting di tutti gli 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 I database dei servizi dei nomi sono progettati per essere relativamente stabili. Nei servizi dei nomi replicati, l'uso frequente delle funzioni RpcNsBindingExport e RpcNsBindingUnexport causa la rimozione ripetuta e la sostituzione della stessa voce da parte del servizio dei nomi, che può causare 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 che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	rpcnsi.h (include Rpc.h)
Libreria	Rpcns4.lib
DLL	Rpcns4.dll

Vedi anche

RpcMgmtEpUnregister

RpcNsBindingExport

RpcNsBindingUnexport