Funzione RpcNsBindingImportBeginA (rpcnsi.h)

Articolo
03/15/2023

La funzione RpcNsBindingImportBegin crea un contesto di importazione per l'importazione di handle di associazione compatibili con il client per i server che offrono l'interfaccia e l'oggetto specificati.

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

Sintassi

RPC_STATUS RpcNsBindingImportBeginA(
  unsigned long EntryNameSyntax,
  RPC_CSTR      EntryName,
  RPC_IF_HANDLE IfSpec,
  UUID          *ObjUuid,
  RPC_NS_HANDLE *ImportContext
);

Parametri

EntryNameSyntax

Sintassi di EntryName.

Per usare la sintassi specificata nella voce del valore del Registro di sistemaHKEY_LOCAL_MACHINE\Software\Microsoft\Rpc\NameService\DefaultSyntax, specificare RPC_C_NS_SYNTAX_DEFAULT.

EntryName

Puntatore a un nome di voce in corrispondenza del quale inizia la ricerca di handle di associazione compatibili.

Per usare il nome della voce specificato 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 dallo stub che indica l'interfaccia da importare. Se la specifica dell'interfaccia non è stata esportata o non è rilevante per il chiamante, specificare un valore Null per questo parametro. In questo caso, le associazioni restituite sono garantite solo per essere di una sequenza di protocollo compatibile e supportata e contenere l'UUID dell'oggetto specificato. Il server contattato potrebbe non supportare l'interfaccia desiderata.

ObjUuid

Puntatore a un UUID di oggetto facoltativo.

Per un UUID diverso da zero, gli handle di associazione compatibili vengono restituiti da una voce solo se il server ha esportato l'UUID dell'oggetto specificato.

Quando ObjUuid ha un valore di puntatore Null o un UUID nil, gli handle di associazione restituiti contengono uno degli UUID dell'oggetto esportati dal server compatibile. Se il server non ha esportato alcun UUID oggetto, gli handle di associazione compatibili restituiti contengono un UUID dell'oggetto nil.

ImportContext

Handle name-service restituito per l'uso con le funzioni RpcNsBindingImportNext e RpcNsBindingImportDone .

Valore restituito

Valore	Significato
RPC_S_OK	La chiamata ha avuto esito positivo.
RPC_S_INVALID_NAME_SYNTAX	La sintassi del nome non è valida.
RPC_S_NAME_SERVICE_UNAVAILABLE	Il nome supera la lunghezza massima.
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_INVALID_OBJECT	Oggetto non valido.

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

Commenti

Prima di chiamare la funzione RpcNsBindingImportNext , l'applicazione client deve prima chiamare RpcNsBindingImportBegin per creare un contesto di importazione. I parametri di questa funzione controllano l'operazione della funzione RpcNsBindingImportNext .

Al termine dell'importazione degli handle di associazione, l'applicazione client chiama la funzione RpcNsBindingImportDone per eliminare il contesto di importazione.

Nota

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


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

RpcNsBindingImportDone

RpcNsBindingImportNext