Funzione RpcEpUnregister (rpcdce.h)

La funzione RpcEpUnregister rimuove le informazioni sull'indirizzo del server dal database di mapping dell'endpoint locale.

Sintassi

RPC_STATUS RpcEpUnregister(
  RPC_IF_HANDLE      IfSpec,
  RPC_BINDING_VECTOR *BindingVector,
  UUID_VECTOR        *UuidVector
);

Parametri

IfSpec

Interfaccia per annullare la registrazione dal database della mappa degli endpoint locale.

BindingVector

Puntatore a un vettore di handle di associazione per annullare la registrazione.

UuidVector

Puntatore a un vettore facoltativo di UUID oggetto per annullare la registrazione. L'applicazione server costruisce questo vettore. RpcEpUnregister annulla la registrazione di tutti gli elementi del database di mapping degli endpoint corrispondenti ai parametri IfSpec e BindingVector specificati e agli UUID dell'oggetto.

Un valore di parametro Null indica che non sono presenti UUID oggetto per annullare la registrazione.

Valore restituito

Valore	Significato
RPC_S_OK	La chiamata ha avuto esito positivo.
RPC_S_NO_BINDINGS	Nessun binding.
RPC_S_INVALID_BINDING	L'handle di associazione non è valido.
RPC_S_WRONG_KIND_OF_BINDING	Questo è stato il tipo di associazione sbagliato per l'operazione.

 

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

 

Commenti

La funzione RpcEpUnregister rimuove gli elementi dal database endpoint-map dell'host locale. Un'applicazione server chiama questa funzione solo quando il server ha registrato in precedenza endpoint e il server vuole rimuovere tali informazioni dall'endpoint-map database.

In particolare, RpcEpUnregister consente a un'applicazione server di rimuovere i propri elementi di database del mapping degli endpoint (informazioni sull'indirizzo del server) in base alla specifica dell'interfaccia o alla specifica dell'interfaccia e agli oggetti UUID delle risorse offerte.

Il server chiama la funzione RpcServerInqBindings per ottenere il parametro BindingVector richiesto. Per annullare la registrazione degli endpoint selezionati, il server può eliminare il vettore di associazione prima di chiamare questa funzione.

RpcEpUnregister crea un prodotto incrociato dai parametri IfSpec, BindingVector e UuidVector e rimuove ogni elemento nel cross-product dal database della mappa degli endpoint.

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	rpcdce.h (include Rpc.h)
Libreria	Rpcrt4.lib
DLL	Rpcrt4.dll

Vedi anche

RpcEpRegister

RpcEpRegisterNoReplace

RpcNsBindingUnexport

RpcServerInqBindings