Funzione RpcNsBindingExportPnPA (rpcnsi.h)

Articolo
11/20/2024

La funzione RpcNsBindingExportPnP stabilisce una voce di database name-service con più handle di associazione e più oggetti per un server che supporta Plug and Play.

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

Sintassi

RPC_STATUS RpcNsBindingExportPnPA(
  unsigned long EntryNameSyntax,
  RPC_CSTR      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 a cui vengono esportati handle di associazione e UUID oggetto. Non è possibile specificare una stringa null o vuota.

Per usare il nome della voce specificata nella voce del valore del Registro di sistema HKEY_LOCAL_MACHINE\Software\Microsoft\Rpc\NameService\DefaultEntry, specificare un puntatore Null o una stringa vuota. In questo caso, il parametro EntryNameSyntax viene ignorato e la libreria di runtime usa la sintassi predefinita.

IfSpec

Struttura dei dati generata da Stub che specifica l'interfaccia da esportare. Un valore Null indica che non sono presenti handle di associazione da esportare (devono essere esportati solo gli UUID oggetto) e BindingVec viene ignorato.

ObjectVector

Puntatore a un vettore di UUID oggetto offerto dal server. L'applicazione server costruisce questo vettore. Un valore Null indica che non sono presenti UUID oggetto da esportare (devono essere esportati solo handle di associazione).

Valore restituito

Valore	Significato
RPC_S_OK	Chiamata riuscita.
RPC_S_NOTHING_TO_EXPORT	Non c'era niente da esportare.
RPC_S_INVALID_BINDING	L'handle di associazione non è valido.
RPC_S_WRONG_KIND_OF_BINDING	Si tratta del tipo errato di associazione per l'operazione.
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_NO_NS_PRIVILEGE	Nessun privilegio per l'operazione name-service.
RPC_S_NAME_SERVICE_UNAVAILABLE	Il servizio dei nomi non è disponibile.

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

Osservazioni

La funzione RpcNsBindingExportPnP consente a un'applicazione server di offrire pubblicamente un'interfaccia nel database name-service che supporta le associazioni Plug and Play per l'uso da parte di qualsiasi applicazione client.

Si noti che l'applicazione server non deve fornire in modo esplicito il vettore di associazione durante l'esportazione di associazioni Plug and Play. Le associazioni vengono aggiornate automaticamente quando si verifica una modifica delle associazioni a causa di un evento Plug and Play.

Nota

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

RpcNsBindingExport

RpcNsBindingUnexportPnP

Condividi tramite