Funzione RpcNsBindingImportBeginA (rpcnsi.h)
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.
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 |
|---|---|
|
La chiamata ha avuto esito positivo. |
|
La sintassi del nome non è valida. |
|
Il nome supera la lunghezza massima. |
|
La sintassi del nome non è supportata. |
|
Il nome è incompleto. |
|
La voce name-service non è stata trovata. |
|
Il servizio dei nomi non è disponibile. |
|
Oggetto non valido. |
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 |