Funzione RpcNsBindingInqEntryName (rpcdce.h)

Articolo
03/05/2024

La funzione RpcNsBindingInqEntryName restituisce il nome della voce da cui proviene l'handle di associazione.

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

Sintassi

RPC_STATUS RpcNsBindingInqEntryName(
  RPC_BINDING_HANDLE Binding,
  unsigned long      EntryNameSyntax,
  RPC_CSTR           *EntryName
);

Parametri

Binding

Handle di associazione il cui nome della voce del database name-service viene restituito.

EntryNameSyntax

Sintassi utilizzata in 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

Restituisce l'indirizzo di un puntatore al nome della voce del database name-service in cui è stato trovato Binding .

Specificare un valore Null per impedire a RpcNsBindingInqEntryName di restituire il parametro EntryName . In questo caso, l'applicazione non chiama la funzione RpcStringFree .

Valore restituito

Valore	Significato
RPC_S_OK	La chiamata ha avuto esito positivo.
RPC_S_INVALID_BINDING	Handle di associazione non valido.
RPC_S_NO_ENTRY_NAME	Nessun nome di voce per l'associazione.
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.

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

Commenti

La funzione RpcNsBindingInqEntryName restituisce il nome del nome della voce del database service-database da cui proviene un handle di associazione compatibile con il client.

La libreria di runtime RPC alloca la memoria per la stringa restituita nel parametro EntryName . L'applicazione è responsabile della chiamata della funzione RpcStringFree per deallocare tale memoria.

Un nome di voce è associato solo agli handle di associazione restituiti dalle funzioni RpcNsBindingImportNext, RpcNsBindingLookupNext e RpcNsBindingSelect .

Se l'handle di associazione specificato nel parametro Binding non è stato restituito da una voce di database name-service, ad esempio se l'handle di associazione è stato creato chiamando RpcBindingFromStringBindingBindingInqEntryName restituisce una stringa vuota ("\0") e un codice di stato RPC_S_NO_ENTRY_NAME.

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