Funzione RpcNsBindingUnexportPnPW (rpcnsi.h)

Articolo
11/20/2024

La funzione RpcNsBindingUnexportPnP rimuove gli handle di associazione per le interfacce e gli oggetti Plug and Play da una voce nel database name-service.

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

Sintassi

RPC_STATUS RpcNsBindingUnexportPnPW(
  unsigned long EntryNameSyntax,
  RPC_WSTR      EntryName,
  RPC_IF_HANDLE IfSpec,
  UUID_VECTOR   *ObjectVector
);

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.

IfSpec

Specifica dell'interfaccia per gli handle di associazione da rimuovere dal database del servizio dei nomi. Un valore di parametro Null indica di non esportare alcun handle di associazione (solo gli UUID oggetto devono essere non esportati).

ObjectVector

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 rpcNsBindingUnexportPnP consente a un'applicazione server di rimuovere gli handle di associazione e gli UUID oggetto delle risorse compatibili con Plug and Play da una voce di database del servizio nomi. Un'applicazione server può annullare l'estensione dell'interfaccia e degli oggetti specificati in una singola chiamata a RpcNsBindingUnexportPnPoppure può annullarle separatamente. Solo gli handle di associazione che corrispondono all'UUID dell'interfaccia e ai numeri di versione principale e secondaria trovati nel parametro IfSpec non sono esportati.

Nota

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

RpcNsBindingExportPnP

RpcNsBindingUnexport

Condividi tramite