Funzione RpcNsBindingInqEntryNameA (rpcdce.h)

Articolo
11/20/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 RpcNsBindingInqEntryNameA(
  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 un valore di 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 RpcNsBindingInqEntryName restituire il parametro EntryName . In questo caso, l'applicazione non chiama la funzione RpcStringFree .

Valore restituito

Valore	Significato
RPC_S_OK	Chiamata riuscita.
RPC_S_INVALID_BINDING	L'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 RPC Return Values.

Osservazioni

La funzione RpcNsBindingInqEntryName restituisce il nome della voce del nome service-database da cui è venuto 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, RpcNsBindingLookupNexte funzioni 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 RpcBindingFromStringBinding), RpcNsBindingInqEntryName restituisce una stringa vuota ("\0") e un codice di stato RPC_S_NO_ENTRY_NAME.

Nota

L'intestazione rpcdce.h definisce RpcNsBindingInqEntryName 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	rpcdce.h (include Rpc.h)
libreria	Rpcrt4.lib
dll	Rpcrt4.dll

Vedere anche

RpcBindingFromStringBinding

RpcNsBindingImportNext

RpcNsBindingLookupNext

RpcNsBindingSelect

RpcStringFree

Condividi tramite