Funzione RpcNsBindingLookupBeginA (rpcnsi.h)

Articolo
11/20/2024

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

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

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 il valore 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 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 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 come una sequenza di protocollo compatibile e supportata e contenere l'UUID dell'oggetto specificato. L'interfaccia desiderata potrebbe non essere supportata dal server contattato.

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.

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 ha esportato alcun UUID oggetto, gli handle di associazione compatibili restituiti contengono un UUID oggetto nil.

BindingMaxCount

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

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 del servizio dei nomi da utilizzare con le funzioni RpcNsBindingLookupNext e RpcNsBindingLookupDone.

Valore restituito

Valore	Significato
RPC_S_OK	Chiamata riuscita.
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_INVALID_OBJECT	Oggetto non valido.

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

Osservazioni

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.

A partire da Windows 2000, l'ambiente RPC usa Active Directory come database name-service e l'ordine in cui l'ambiente di runtime esegue la ricerca è il seguente:

Cercare nella cache locale.
Se la voce non è stata trovata nella cache locale, cercare Active Directory del computer.
Se la voce non è stata 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 eseguirà 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 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

RpcNsBindingLookupDone

RpcNsBindingLookupNext

Condividi tramite