Funzione RpcNsBindingLookupBeginA (rpcnsi.h)

  • Articolo

La funzione RpcNsBindingLookupBegin crea un contesto di ricerca per un'interfaccia e un oggetto.

Nota Questa funzione non è supportata nei sistemi operativi Windows Vista e versioni successive.
 

Sintassi

RPC_STATUS RpcNsBindingLookupBeginA(
  unsigned long EntryNameSyntax,
  RPC_CSTR      EntryName,
  RPC_IF_HANDLE IfSpec,
  UUID          *ObjUuid,
  unsigned long BindingMaxCount,
  RPC_NS_HANDLE *LookupContext
);

Parametri

EntryNameSyntax

Sintassi del parametro EntryName .

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

EntryName

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

Per usare il nome di 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 generata da Stub che indica l'interfaccia da cercare. Se la specifica dell'interfaccia non è stata esportata o non riguarda 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 per contenere l'UUID dell'oggetto specificato. L'interfaccia desiderata potrebbe non essere supportata dal server contattato.

ObjUuid

Puntatore a un oggetto facoltativo UUID.

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

Per un valore puntatore Null o un UUID nil per questo parametro, gli handle di associazione restituiti contengono uno degli UUID oggetto esportati dal server compatibile. Se il server non esportava gli UUID degli oggetti, gli handle di associazione compatibili restituiti contengono un NIL object UUID.

BindingMaxCount

Numero massimo di associazioni da restituire nel parametro BindingVec dalla funzione RpcNsBindingLookupNext .

Specificare un valore pari a zero per usare il conteggio predefinito di RPC_C_BINDING_MAX_COUNT_DEFAULT.

LookupContext

Restituisce un puntatore a un handle name-service da usare con le funzioni RpcNsBindingLookupNext e RpcNsBindingLookupDone .

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_UNSUPPORTED_NAME_SYNTAX
 La sintassi del nome non è supportata.
RPC_S_INCOMPLETE_NAME
 Il nome è incompleto.
RPC_S_ENTRY_NOT_FOUND
 Non è stata trovata la voce nome-servizio.
RPC_S_NAME_SERVICE_UNAVAILABLE
 Il servizio nome non è disponibile.
RPC_S_INVALID_OBJECT
 Oggetto non valido.
 
Nota Per un elenco di codici di errore validi, vedere Valori restituiti RPC.
 

Commenti

La funzione RpcNsBindingLookupBegin crea un contesto di ricerca per individuare handle di associazione compatibili con il client ai server che offrono l'interfaccia e l'oggetto specificati.

Prima di chiamare RpcNsBindingLookupNext, l'applicazione client deve prima chiamare RpcNsBindingLookupBegin per creare un contesto di ricerca. I parametri di questa funzione controllano l'operazione della funzione RpcNsBindingLookupNext .

Efficace con Windows 2000, l'ambiente RPC usa Active Directory come database nome-servizio e l'ordine in cui l'ambiente di runtime esegue la ricerca è il seguente:

  • Cercare nella cache locale.
  • Se la voce non viene trovata nella cache locale, cercare Active Directory del computer.
  • Se la voce non viene trovata nel computer locale, inviare richieste di trasmissione a tutti gli altri servizi di Active Directory nel dominio.

    Si noti che se la voce esiste in Active Directory, ma non sono presenti informazioni associate alla voce, l'ambiente di runtime non emetterà questa richiesta di trasmissione.

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

Nota

L'intestazione rpcnsi.h definisce RpcNsBindingLookupBegin come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.

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

Vedi anche

RpcNsBindingLookupDone

RpcNsBindingLookupNext